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METHOD AND SYSTEM FOR ACCESSING A PIECE OF CONTENT STORED ON 
AN EXTERNAL CONTENT MANAGEMENT SYSTEM 

FIELD OF THE INVENTION 
5 The present invention relates to a method and system for accessing a piece of content 
stored on an external Content Management System (CMS) and more particularly to a 
method and system for a business processes wishing to access and modify content 
stored on an externa! CMS, without requiring the business processes to have prior 
knowledge of how or where the content is stored. 

10 

DESCRIPTION OF THE PRIOR ART 

The present invention is directed to ensuring how business processes, typically found 
in the middle tiers of a multi-tier architecture, can access content independent as to 
how the content is stored so that both the business processes and the content may 
1 5 continue to evolve independent of each other. 

In the context of publishing, content can exist in many formats in many different 
locations, both from a geographic point of view as well as from a computer system 
point of view. In order to ensure that a publishing system can have access to all 
20 existing content and future content it is necessary to create a uniform method of 
representing and accessing it. 

Existing methods that attempted to address this problem are general and do not 
sufficiently encapsulate the idea of content from the publishing perspective. These 
25 methods include SQL and ODBC, but are only useful if content exists in relational 
databases. These methods also require middle-ware to handle the accessing of the 
content. 

The challenges in electronic publishing include being able to organize and provide 
30 access to content that may exist within or outside an organization, as well as unifying 
the access and work-flow of the content for users. 
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SUMMARY OF THE INVENTION 

An object of the invention is to provide a system that can overcome the problems 
identified in the prior art. 

5 In broad terms, the present invention is directed to an interface defining the way in 
which a business process can interface with an external Content Management 
System. 

Stated differently, the invention concerns a universal object representation of a CMS 
10 defining a partnership between hierarchically organized content and the business 
processes wishing to access and modify the content, without requiring the business 
processes to have prior knowledge of how or where the content is stored. 

The invention further defines a model to manage multiple content sources each 
15 providing access to the abstracted content using the same interface. 

According to the present invention, there is provided a method for a business process 
hosted on an application server to request content from at least one external content 
management system independently of the manner in which the content is stored. The 

20 method comprises the step of making a content request from the business process to 
one of the at least one external content management system via a content 
management system server managing the content request from the business process 
to one of the at least one external content management system; transmitting the 
content request between one of the at least one external content management system 

25 and the content management system server via a content management system driver 
interface translating a piece of content corresponding to the content request from one 
of the at least one external content management system into a specific object 
representation, the content management system driver interface being operatively 
associated with the at least one external content management system; managing the 

30 content request from the business process to one of the at least one external content 
management system and keeping track of content available from one of said at least 
one external content management system operatively associated with the 
corresponding content management system driver interface via a content 
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management system manager; and relaying the specific object representation of the 
content from the content management system driver interface to the business process 
via the content management system server. 

5 According to the present invention, there is also provided a system for a business 
process hosted on an application server to request content from at least one external 
content management system independently of the manner in which the content is 
stored. The svstem comprises a content manaaement svstem server for manaaina a 
content request from the business process to the external content management 

10 system; a content management system driver interface operatively associated with the 
at least one external content management system for transmitting the content request 
between one of the at least one external content management system and the content 
management system server, the content management system driver interface 
translating a piece of content corresponding to the content request from one of the at 

15 least one external content management system into a specific object representation; 
and a content management system manager for managing the content request from 
the business process to one of the at least one external content management system 
and keeping track of content available from one of the at least one external content 
management system operatively associated with one of the corresponding content 

20 management system driver interface. The content management system server relays 
the specific object representation of the content from the content management system 
driver interface to the business process. 

BRIEF DESCRIPTION OF THE DRAWINGS 
25 The present invention will be better understood after having read a detailed 
description of preferred embodiments thereof made in reference to the following 
drawings, in which like numbers refer to like elements: 

Figure 1 is a schematic high-level representation of a system according to a preferred 
30 embodiment of the present invention. 

Figures 2 to 7 are schematic representations of UML class models of a system 
according to a preferred embodiment of the invention, showing different packages. 



4 



Figure 8 is a schematic representation of relationships between the business process 
and the external CMS in the context of deployment in a web-server environment, 
according to a preferred embodiment of the present invention. 

5 

DESCRIPTION OF A PREFERRED EMBODIMENT OF THE INVENTION 

Referring now to Fig. 1, there is shown a high-level representation of a system 

ar-oorrlinn tn a nrofornaH <=>mhrvHimAnt nf thp present invention. For a business DroceSS 
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1 hosted on an application server to request content from one external Content 
10 Management System 5 (hereinafter referred to as external CMS) independently of the 
manner in which the content is stored, a universal object representation of a Content 
Management System (hereinafter referred to as CMS) is provided. This universal 
object representation of the CMS comprises a Content Management System Server 2, 
a Content Management System Manager 3, and a Content Management System 
15 Driver Interface 4 (hereinafter referred to as CMS Server, CMS Manager and CMS 
Driver Interface). The CMS Server, CMS Manager and CMS Driver Interface are all 
implemented according to a set of abstract classes. 

Now turning to Figs. 2 to 7, a piece of content being managed by the external CMS 
20 can be a news article, a JPEG image, or a group of other content items that share a 
common parent. To this extent a hierarchical and recursive model for content is 
defined. 

In order to abstract the relationship between the business process 1 and content that 
25 it may require, an object representation of a piece of content is defined as an Item. 
Items of content are represented as an instantiation of the Item class 6. The Item 
class 6 can represent any type of content, such as documents, multimedia files, etc. 
An ItemFactory class 8 for constructing the Items themselves is also defined. Content 
Items can be related to each other via a relationship so that one Item can be the 
30 parent of one or more Items. The Item is categorized by its type, and can be 
represented by the ItemType class 10. The business process 1 obtains an instance of 
an ItemFactory and instructs the ItemFactory to create the instances of the Item it 
requires. The Item can then provide access to the content data itself, which is stored 
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in Fields class 12, by instructing the Item's ItemType to return a list of the Item's 
Fields. The business process 1 can manipulate the Items' Field data itself. 

In this manner, it is possible for the business process 1 in a middle tier, of a multi-tier 
5 software architecture, to be programmed without prior knowledge of the external CMS 
5. The business process 1 only needs to reference the content object model by 
referring to ItemFactory and the Items it creates. The business process 1 only 
specifies a very generic description of the content it requires in the form of ItemType 
and Fields. The object model Factory takes care of actually creating the content object 
10 itself. 

When the business process 1 requires access to a piece of content, which may 
physically exist in the external CMS, the business process 1 makes a request for a 
required piece of content to the universal object representation of the CMS. The CMS 

1 5 Driver Interface 4 comprises one or many driver(s) each operatively associated with 
one corresponding external C MS 5 . The d river actually i mplements the methods to 
access the content on the external CMS 5 by sending specific parameters, such as an 
URL and a set of credentials (username, passwords, etc.), and forwards the content 
request to the external CMS 5. The CMS Driver Interface 4 is responsible for 

20 transmitting the content request between the external CMS 5 and the CMS Server 2. 
The CMS Driver Interface 4 translates a piece of content corresponding to the content 
request from one external CMS 5 into an Item object representation. The CMS Driver 
Interface class implements the driver and, as part of its initialization, the driver 
registers itself with the CMS Manager 3. 

25 

Stated differently, the driver defines a set of methods that must be implemented to 
allow an E-Platform to communicate with an external CMS. The E-Platform Business 
Process Core would only need to communicate with the driver to function 
independently of the content that it needs access to. Thus, the business process that 
30 is implemented, primarily in Java, makes requests to the CMS Manager 3 asking for 
content of a specific type. 
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The CMS Server 2 manages the content request from the business process 1 to the 
external CMS 5 using the CMS Driver Interface 4. The CMS Server 2 also relays the 
Item object representation of the piece of content from the driver to the business 
process. 

5 

The CMS Manager 3 manages the content request from the business process to one 
of the external CMS 5 and keeps track of content available from one of the external 
CMS 5 operative! 4 / associated with the corresponding driver. To keep track of the 
content available via a specific driver, the CMS Manager registers the drivers currently 
10 running. The CMS Manager can also unregister these drivers. Managing the content 
sources is implemented through the CMS Manager class that defines methods for 
adding and connecting to CMS Server's. 

The system preferably has a CMS Security Manager for controlling an access to the 
15 functionalities of the driver according to specific parameters. The CMS Security 
Manager controls access to the driver according to the set of credentials. 

Business processes 1 access content items individually or as collections by making a 
request to Item Factory. The Item Factory constructs one or more Items according to 
20 the request and returns the Items as individual items or as collections of Items. The 
business process can then interrogate the Items by invoking the Items methods to 
extract Field information and other Item properties. 

The business process gains access to an Items fields by instructing the Item's 
associated FieldFactory to manufacture the Items fields. 

25 

An Item is defined to be unique within an external CMS according to the Items 
Primary-Key. 

Possible packages that can be used for implementing the different CMS class needed 
30 are listed hereinabove as examples and for complete comprehension of the preferred 
embodiment of the system of the present invention: 
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1 CLASS DOCUMENTATION 

1.1 PACKAGE COM.CONCEPTIS.CMS 

1.1.1 Class Action 

5 java. lang. Object 
I 

+ - com . concept is . cms • Action 

public class Action 
1 0 extends java.lang.Object 

An Action is performed on a secureResource by a cmsuser and must be authorized by the 
SecurityManager to be performed. 

An Action is simply identified by its name, and this class already provides a useful set of 
predefined Actions. 



Field Summary 


static Action 


DELETE 

Defines an Action that removes data from the CMS. 


static Action 


INSERT 

Defines an Action that creates new data in the CMS. 


private 
j ava . lang . String 


name 

the name of this Action 


static Action 


READ 

Defines an Action that reads data from the CMS. 


static Action 


UPDATE 

Defines an Action that modifies existing data in the CMS. 



Constructor Summary _ _ _ : _ 

I Action (java. lang. String name) 

An Action is performed on a SecureResource by a CmsUser and must be authorized 
|by the SecurityManager to be performed. ^ 



Method Summary 


boolean 


equals (java. lang. Object ob j ) 

Returns true if the obj parameter defines an Action that share the 
same name as this one; false otherwise. 


j ava . lang . String 


getName () 

Returns the name of this Action. 
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private void 



setName (java . lang . String name) 
Sets the name of this Action. 



Methods inherited from class java.Iang.Object 

clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, 
wait 



Field Detail 

1.1.1.1 READ 

public static final Action READ 

Defines an Action that reads data from the CMS. 



1.1.1.2 INSERT 



public static final Action INSERT 

Defines an Action that creates new data in the CMS. 



1.1.1.3 UPDATE 



public static final Action UPDATE 

Defines an Action that modifies existing data in the CMS. 



1.1.1.4 DELETE 



public static final Action DELETE 

Defines an Action that removes data from the CMS. 



1.1.1.5 name 

private java . lang. String name 
the name of this Action 

Constructor Detail 



1.1.1.6 Action 

public Action (java . lang. String name) 

An Action is performed on a secureResource by a cmsuser and must be authorized 

by the securityManager to be performed. 
Parameters: 
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name - the unique name the identifies this Action 

Method Detail 



1.1.1.7 getName 

public final java . lang . String getName ( ) 
5 Returns the name of this Action. 

Returns: 

the name of this Action 



1.1.1.8 setName 

10 

private void setName (j ava . lang. String name) 
Sets the name of this Action. 
Parameters: 

name - the unique name the identifies this Action 
15 

1.1.1.9 equals 

public boolean equals ( java . lang. Object obj) 

Returns true if the obj parameter defines an Action that share the same name as this 
20 one; false otherwise. 

Overrides: 

equals in class java. lang. Object 
Parameters: 

obj - the object to compra for equality with this Action 
25 Returns: 

true if the obj parameter defines an Action that share the same name as this one; false 
otherwise. 



1.1.2 Class CmsException 

30 java . lang. Object 

I 

+- - java . lang. Throwable 

i 

java . lang. Exception 

35 | 

+- -com. concept is .cms .CmsException 

All Implemented Interfaces: 

j ava. io . Serializable 
Direct Known Subclasses: 

40 AuthenticationException . AuthorizationException . ConnectionException , 

MissingResourceException , ModifiedResourceException 

public class CmsException 

extends java.lang.Exception 

45 Base class for exceptions thrown by the CMS driver. 
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See Also: 

Serialized Form 



Constructor Summary 

Cms Ex caption ( ) 

Creates a new instance of cms Except ion without detail message. 
CmsException ( java . lang . String msg) 

Constructs an instance of CmsException with the specified detail message. 
CmsException ( j ava . lang . String msg, j ava . lang . Throwable cause) 

Constructs an instance of CmsException with the specified detail message. 

CmsException ( j ava . lang . Throwable cause) 

Creates a new instance of CmsException without detail message. 



Methods inherited from class java.lang.Throwable 

f illlnStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 
initCause, printStackTrace, printStackTrace , printStackTrace, setStackTrace , 
toString 



5 



Methods inherited from class javaJang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 



■ ■■ . . 

Constructor Detail 

1 .1 .2.1 CmsException 
publ i c CmsException ( ) 

Creates a new instance of CmsException without detail message. 
10 

1.1.2.2 CmsException 

public CmsException (java . lang . String msg) 

Constructs an instance of CmsException with the specified detail message. 
Parameters: 
1 5 msg - the detail message. 



1.1.2.3 CmsException 

public CmsException (java . lang. Throwable cause) 

Creates a new instance of CmsException without detail message. 
20 Parameters: 
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cause - the root cause of the exception 



1 .1 .2.4 CmsException 

public CmsException (java.lang. String msg, 
5 java.lang.Throwable cause) 

Constructs an instance of CmsException with the specified detail message. 
Parameters: 

msg - the detail message. 

cause - the root cause of the exception 

10 

1 .1 .3 Class connection Exception 

j ava . lang . Ob j ect 

i 

+ - - j ava . lang . Throwable 

15 | 

+-- java . lang. Exception 

i 

+- -com. conceptis . cms . CmsException 

20 +- -com. conceptis .cms .ConnectionException 

All Implemented Interfaces: 

j ava . io . S erializable 



public class ConnectionException 

25 extends CmsException 

Indicates that there is a problem connecting the driver to the actual CMS. 
See Also: 



Serialized Form 




j ConnectionException ( ) 



Creates a new instance of ConnectionException without detail message. 
ConnectionException (java . lang. String msg) 

Constructs an instance of ConnectionException with the specified detail message. 
ConnectionException (java . lang. String msg, java.lang.Throwable cause) 

Constructs an instance of ConnectionException with the specified detail message. 
ConnectionException ( j ava . lang . Throwable cause) 

Creates a new instance of ConnectionException without detail message. 
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Methods inherited from class java.lang.Throwable 

f illlnS tackTrace , getCause , getLocal izedMes sage , ge tMessage , get StackTrace , 
ini tCause , printStackTrace , printStackTrace , pr intStackTrace , sets tackTrace , 
toString 
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{Methods inherited from class java.Iang.Object 

(clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
jwait 



I Constructor Detail 



1 .1 .3.1 ConnectionException 
public ConnectionException () 

5 Creates a new instance of ConnectionException without detail message. 



1 .1 .3.2 ConnectionException 

public ConnectionException (java.lang. String msg) 

Constructs an instance of ConnectionException with the specified detail message. 
1 0 Parameters: 

msg - the detail message. 



1 .1 .3.3 ConnectionException 

public ConnectionException (java. lang . Throwable cause) 
1 5 Creates a new instance of ConnectionException without detail message. 

Parameters: 

cause - the root cause of the exception 



1 . 1 .3.4 ConnectionException 
20 public ConnectionException (java. lang. String msg, 

java . lang. Throwable cause) 
Constructs an instance of ConnectionException with the specified detail message. 
Parameters: 

msg - the detail message. 
25 cause - the root cause of the exception 

1.1.4 Class DriverManager 

java. lang. Object 
30 + - - com • concep tis . cms . DriverManager 

public class DriverManager 

extends java.Iang.Object 

CMS Driver managerment class. This class is capable of registering and unregistering drivers, 
35 and providing connections to a CMS via the registered drivers. 
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Driver s are expected to register themselves with the DriverManager when the class is first 
loaded by the class loader. 

See Also: 

Driver 



Field Summary 


private 

static java .util .HashSet 


drivers 

The set of registered drivers. 


private 

static org. apache . iog4j . Logger 


log 

For logging purposes. 



Constructor Summary 



I .... % ' 



D r i ve rManag er ( ) 



Method Summary 



static void 


deregisterDriver (Driver driver) 

Removes a Driver from the collection of registered 
drivers. 


static Connection 


getConnec tion ( j ava . lang . String url ) 

Attempts to establish a connection to the CMS at the 
specified URL. 


static Driver 


getD river (java . lang . String url) 

Provides the driver requested in the URL. 


static java .util . Iterator 


getDrivers () 

Provides the collection of registered drivers. 


static void 


registerDriver (Driver driver) 

Registers a driver with the DriverManager. 



Methods inherited from class java.lang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 
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Field Detail 



1.1.4.1 log 

private static org. apache . log4j . Logger log 
For logging purposes. 



5 1.1.4.2 drivers 

private static java .util .HashSet drivers 

The set of registered drivers. This is initialized when the class is first loaded. Note that 
t he drivers contain no state information, and may be shared by any number of objects. 

| Constructor Detail 

1.1.4.3 DriverManager 
10 public DriverManager ( ) 

_^_.„„..„...,, . 



Method Detail 



1 .1 .4.4 getConnection 

public static Connection getConnection (java . lang. String url) 

throws CmsException 
Attempts to establish a connection to the CMS at the specified URL. 
15 Parameters: 

url - the url to attempt to connect to 
Returns: 

a connection for the database 
Throws: 

20 CmsException - if an error occurs 



1.1.4.5 registerDriver 

public static void registerDriver ( Driver driver) 

throws CmsException 
25 Registers a driver with the DriverManager. 

Parameters: 

driver - the driver to register 
Throws: 

CmsException - if an error occurs 
30 

1 .1 .4.6 deregisterDriver 

public static void deregisterDriver ( Driver driver) 

throws CmsException 
Removes a Driver from the collection of registered drivers. 
35 Parameters: 

driver - the driver to unregister 
Throws: 

CmsException - if an error occurs 



15 

1.1.4.7 getDrivers 

public static j ava . util . Iterator getDrivers { ) 
Provides the collection of registered drivers. 
Returns: 

5 the collection of registered drivers 



1.1.4.8 getDriver 

public static Driver getDriver (j ava . lang . String url) 
Provides the driver requested in the URL. 
1 0 Parameters: 

url - the url specifying the driver 
Returns: 

an appropriate driver, null if none could be found 
15 1.1.5 Class ItemSearchConstraints 

j ava . lang . Ob j ect 

i 

+ - - com. conceptis. cms .ItemSearchConstraints 



20 public class ItemSearchConstraints 

extends java.lang.Object 

Provides constraints on a search for items. 



Field Summary 


private 
java .util . Set 


authors 

The set of cmsusers to limit the results by. 


private 
java .util . Set 


collections 

The set of collections to limit the results by. 


private boolean 


deep 

Whether the search should be deep (recursively look in item 
children). 


private 
java .util . Date 


endDate 

The end date to constrain the search by. 


private 
java .util . Set 


fields 

The fields to search in. 


private boolean 


f ieldUnion 

Whether the fields are a union or not. 


private 
j ava . lang . String 


f reeQuery 

The free query search term. 


private 
java .util .Map 


indices 

The indices used to limit the search. 


private 
j ava . lang . Integer 


maxResults 

The maximum number of results to return. 
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private int 


resultsPerPage 

The number of results per page, if supported. 


static int 


SORT AUTHOR 

Sort by author. 


static int 


SORT FIELD 

Sort by field. 


static int 


SORT ID 

Sort by Id. 


static int 


SORT NAME 

Sort by name. 


static int 


SORT NONE 

No sorting. 


static int 


SORT SCORE 

Sort by score. 


static int 


SORT TYPE 

Sort by item type. 


static int 


SORT UPDATE 

Sort by update date. 


private 
java .util . Set 


sortFields 

The fields to sort by. 


private int 


sortOrder 

Sort method. 


private Item 


start 

The starting point. 


private 
java .util .Date; 


startDate 

The start date to constrain the search by. 


static int 


TEXT SEARCH EXACT 

Constant for exact text searches. 


static int 


TEXT SEARCH FUZZY 

Constant for fuzzy text searches. 


static int 


TEXT SEARCH NORMAL 

Constant for normal text searches. 


private int 


textSearchType 

The type of text search to perform. 


private "■. 
java .util . Set 


types 

The set of itemTypes to limit the results by. 


private 
java . lang. String 


value 

The value to search for. 


private 
java .util . Collection 


valueFields 

The collection of value/fields. 
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Constructor Summary 

ItemSearchConstraints () 



Method Summary 


void. 


addAuthor ( Cms User user) 

Adds an author id to the search constraints. 


void 


addCollection (java . util . Collection collection) 
Adds a collection id to the search constraints. 


void 


addField (Field field) 

Deprecated, use value/fields object and free query value 


void 


add Index Value (Index index, java . lanq. Strinq value) 
Adds an index to constrain the search. 


void 


addltemType (ItemType type) 

Adds a item type id to the search constraints. 


void 


aaasortFiela (Field field) 

Adds a sort field id to the search constraints. 


void 


addValueFields (ValueFields constraint) 
Adds a value/fields constraint. 


java.util.Set 


getAuthors () 

Provides the set of authors used to constrain the search. 


java.util.Set 


getCollections ( ) 

Provides the set of collections used to constrain the search. 


java .util .Date 


getEndDate () 

Provides the end date of the search constraints. 


~\ a ~\rPi nt~"il Cof* 
java . uuix . oci. 


rrft t-T?-i al^a M 

Deprecated, use value/fields object and free query value 


java . lang. String 


getFreeQuery ( ) 

Provides the free query part. 


java .util . Map 


getlndices ( ) 

Provides the index values. 


java.util.Set 


getltemTypes () 

Provides the set of item types used to constrain the search. 


java . lang. Integer 


getMaximumResults () 

Provides the maximum number of results this search is to 
return. 


int 


getResult sPerPage ( ) 

Provides the number of results per page. 


java .util . Set 


getSortFields 0 

Provides the set of sort fields used to constrain the search. 


int 


getSortOrder () 
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Provides the sort order. 


java. util .Date 


getStartDate () 

Provides the start date of the search constraints. 


Item 


getStartPoint ( ) 

Provides the starting point. 


int 


getTextSearchType ( ) 

Provides the text search type. 


j ava . lang . String 


getValue ( ) 

Deprecated, use value/fields object and free query value 


java .util .Collection 


getValueFields () 

Provides the value/fields constraints. 


boolean 


isDeep () 

Indicates whether the search is a deep search, that recursively 
searches through child links. 


boolean 


isFieldUnionO 

Deprecated, use value/fields object and free query value 


void 


removeAuthor (CmsUser user) 

Removes an author id from the search constraints. 


void 


removeCollection (java . ut il . Collection collection) 
Removes a collection id from the search constraints. 


void 


removeField (Field field) 

Deprecated, use value/fields object and free query value 


void 


remove I temType (ItemType type) 

Removes a item type id from the search constraints. 


void 


removeSortField (Field field) 

Removes a sort field id from the search constraints. 


void 


setDeep (boolean deep) 

Sets whether the search is a deep search, that recursively 
searches through child links. 


void 


setEndDate (java .util .Date date) 

Sets the end date of the search constraints. 


void 


setFieldUnion (boolean f ieldUnion) 

Deprecated, use value/fields object and free query value 


void 


setFreeQuery ( j ava . lang . String f reeQuery ) 
Sets the free query part. 


void 


setMaximumResults (java . lanq. Inteqer max) 

Sets the maximum number of results this search is to return. 


void 


setResultsPerPage (int resultsPerPaqe) 
Sets the number of results per page. 


void 


setSearchType ( int type ) 

Sets the text search type. 


void 


setSortOrder (int sortOrder) 
Sets the sort order. 


void 


setStartDate (java .util .Date date) 

Sets the start date of the search constraints. 
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void 


setStartPoint (Item start) 

Sets the starting point. 


void 


setValue (java . lang. String value) 

Deprecated, use value/fields object and free query value 


java . lang. String 


toString () 

Provides a string representation of this object. 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 



Field Detail 



1.1.5.1 TEXT_SEARCH_EXACT 

public static final int TEXT_SEARCH_EXACT 

5 Constant for exact text searches. 

See Also: 

Constant Field Values 



1 .1 .5.2 TEXT_SEARCH_FUZZY 
10 public static final int TEXT_SEARCH_FUZZY 
Constant for fuzzy text searches. 
See Also: 

Constant Field Values 
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15 1.1 .5.3 TEXT_SEARCH_NORMAL 

public Static final int TEXT_SEARCH_NORMAL 

Constant for normal text searches. 
See Also: 

Constant Field Values 



1.1.6 SORT_NONE 

public static final int SORT_NONE 
No sorting. 
See Also: 
25 Constant Field Values 



1.1.6.1 SORT_AUTHOR 

public static final int SORT_AXJTHOR 

Sort by author. 
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See Also: 

Constant Field Values 



1.1.6.2 SORTJJPDATE 
5 public static final int SORT_UPDATE 
Sort by update date. 
See Also: 

Constant Field Values 



10 1.1.6.3 SORTTYPE 

public static final int SORT_TYPE 
Sort by item type. 
See Also: 

Constant Field Values 



1.1.6.4 SORTJMAME 

public static final int SORT_NAME 

Sort by name. 

See Also: 
20 Constant Field Values 



1.1.6.5 SORTJD 

public static final int SORT ID 
Sort by Id. 
25 See Also: 

Constant Field Values 



1.1.6.6 SORT_SCORE 

public static final int SORT_SCORE 

30 Sort by score. 

See Also: 

Constant Field Values 



1.1.6.7 SORT_FIELD 
35 public static final int SORT_FIELD 
Sort by field. 
See Also: 

Constant Field Values 
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1.1.6.8 authors 

private j ava . util . Set authors 

The set of cmsusers to limit the results by. Null/empty indicates no limiting. 
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1.1.6.9 collections 

private java.util .Set collections 

The set of collections to limit the results by. Null/empty indicates no limiting. 



1.1.6.10 types 

private java.util .Set types 

The set of itemTypes to limit the results by. Null/empty indicates no limiting. 



1.1.6.11 sortFields 

private java.util .Set sortFields 
The fields to sort by. 



1.1.6.12 deep 

private boolean deep 

Whether the search should be deep (recursively look in item children). 



1.1.6.13 startDate 

private java.util .Date startDate 

The start date to constrain the search by. Null/empty indicates no limiting. 



1.1.6.14 endDate 

private j ava . util . Date endDate 

The end date to constrain the search by. Null/empty indicates no limiting. 



1.1.6.15 maxResults 

private j ava . lang. Integer maxResults 

The maximum number of results to return. Null indicates to return all results. 



1.1.6.16 textSearchType 
private int textSearchType 

The type of text search to perform. Defaults to TEXT SEARCH NORMAL. 



1.1.6.17 sortOrder 
private int sortOrder 
Sort method. 



1 .1 .6.1 8 resultsPerPage 
private int resultsPerPage 

The number of results per page, if supported. 



1.1.6.19 start 
private item start 
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The starting point. 



1.1.6.20 valueFields 

private java.util . Collection valueFields 
The collection of value/fields. 



i \j 



1.1.6.21 freeQuery 

private java . lang . String freeQuery 
The free query search term. 



1.1.6.22 indices 

private java . util .Map indices 

The indices used to limit the search. Maps index->values 



15 1.1.6.23 value 

private j ava . lang . S t r ing value 
The value to search for. 



1.1.6.24 fields 
20 private java . util . Set fields 

The fields to search in. If empty, a full text search will be performed. 



1.1.6.25 fieldUnion 
private boolean fieldUnion 
25 Whether the fields are a union or not. 



Constructor Detail 



1 .1 .6.26 ItemSearchConstraints 
public ItemSearchConstraints ( ) 



Method Detail 



1.1.6.27 addAuthor 

public void addAuthor ( CmsUser user) 
30 Adds an author id to the search constraints. If the author is already in the contraints, 

this method does nothing but does not complain. 
Parameters: 
user - the author 

35 1.1 .6.28 removeAuthor 

public void removeAuthor ( CmsUser user) 

Removes an author id from the search constraints. If the author is not in the contraints, 
this method does nothing but does not complain. 
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Parameters: 

user - the author 



1.1.6.29 getAuthors 

public java .util . Set getAuthors () 

Provides the set of authors used to constrain the search. 
Returns: 

the set of authors used to constrain the search; may be null 



1 1 ftin oHHpAllo/stlAn 

public void addCol lection ( java . util . Collection collection) 

Adds a collection id to the search constraints. If the collection is already in the 
constraints, this methods does nothing but does not complain. 
Parameters: 

collection - the the collection 



1 .1 .6.31 removeCollection 

public void removeCollection (java . util . Collection collection) 

Removes a collection id from the search constraints. If the collection is not in the 

contraints, this method does nothing but does not complain. 

Parameters: 

collection - the collection 



1 .1 .6.32 getCollections 

public java .util . Set getCollections ( ) 

Provides the set of collections used to constrain the search. 
Returns: 

the set of collection ids used to constrain the search; may be null 



1.1.6.33 addltemType 

public void addltemType ( ItemType type) 

Adds a item type id to the search constraints. If the type is already in the constraints, 

this methods does nothing but does not complain. 

Parameters: 

type - the item type 



1 . 1 .6.34 removeltemType 

public void removeltemType ( ItemType type) 

Removes a item type id from the search constraints. If the type is not in the contraints, 

this method does nothing but does not complain. 

Parameters: 

type - the item type 
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1.1.6.35 getltemTypes 

public java.util .Set getltemTypes { ) 

Provides the set of item types used to constrain the search. 
Returns: 

the set of item types used to constrain the search; may be null 



1.1.6.36 addSortField 

public void addSortField ( Field field) 

Adds a sort field id to the search constraints. If the field is already in the constraints, 
this methods does nothing but does not complain. 
Parameters: 
field -the field 



1 . 1 .6.37 removeSortField 

public void removeSortField ( Field field) 

Removes a sort field id from the search constraints. If the field is not in the contraints, 
this method does nothing but does not complain. 
Parameters: 
field - the field 



1.1.6.38 getSortFields 

public java.util. Set getSortFields ( ) 

Provides the set of sort fields used to constrain the search. 
Returns: 

the set of field ids used to constrain the search; may be null 



1.1.6.39 isDeep 

public boolean isDeep ( ) 

Indicates whether the search is a deep search, that recursively searches through child 

links. 

Returns: 

true if the search is deep, false otherwise 



1.1.6.40 setDeep 

public void setDeep (boolean deep) 

Sets whether the search is a deep search, that recursively searches through child links. 
Parameters: 

deep - true if the search is to be deep, false otherwise 



1.1.6.41 getStartDate 

public java .util . Date getStartDate ( ) 

Provides the start date of the search constraints. 
Returns: 

the starting date that is constraining the search 
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1.1.6.42 setStartDate 

public void setStartDate (java . util . Date date) 
Sets the start date of the search constraints. 
Parameters: 

date - the starting date to constrain the search 



1.1.6.43 getEndDate 

public java. util. Date getEndDate ( ) 

Provides the end date of the search constraints. 
Returns: 

VXAW VlHilll^, V*MVW U1WV »U UlUlll^j U1V JVU1V11 



1.1.6.44 setEndDate 

public void setEndDate ( j ava . util . Date date) 
Sets the end date of the search constraints. 
Parameters: 

date - the ending date to constrain the search 



1 .1 .6.45 getMaximumResults 

public java. lang. Integer getMaximumResults { ) 

Provides the maximum number of results this search is to return. Null indicates no limit 

to the number of results returned. 

Returns: 

the maximum number of search results (null indicates no limit) 



1 .1 .6.46 setMaximumResults 

public void setMaximumResults (java . lang. Integer max) 

Sets the maximum number of results this search is to return. Null indicates no limit to 

the number of results returned. 

Parameters: 

max - the maximum number of search results (null indicates no limit) 



1 . 1 .6.47 getTextSearchType 

public int getTextSearchType ( ) 

Provides the text search type. The default text search type is a "normal" search (neither 

exact not fuzzy). 

Returns: 

the type of text searching being done 



1 . 1 .6.48 setSearchType 

public void setSearchType (int type) 
Sets the text search type. 
Parameters: 

type - the text search type 
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1.1.6.49 getStartPoint 

public Item getStartPoint ( ) 

Provides the starting point. 

Returns: 

the starting point 



1.1.6.50 setStartPoint 

public void setStartPoint ( Item start) 
Sets the starting point. 
Parameters: 

start - the starting point 



1.1.6.51 getSortOrder 

public int getSortOrder ( ) 

Provides the sort order. 

Returns: 

sort order 



1.1.6.52 setSortOrder 

public void setSortOrder (int sortOrder) 
Sets the sort order. 
Parameters: 

sortorder - the sort order 



1.1.6.53 getResultsPerPage 

public int getResultsPerPage ( ) 

Provides the number of results per page. 

Returns: 

the number of results per page 



1 .1 .6.54 setResultsPerPage 

public void setResultsPerPage (int resultsPerPage) 
Sets the number of results per page. 
Parameters: 

resultsPerPage - the number of results per page 



1.1 .6.55 getFreeQuery 

public java . lang. String getFreeQuery ( ) 
Provides the free query part. 
Returns: 

the free query part (can be null) 



1 . 1 .6.56 setFreeQuery 

public void setFreeQuery (java . lang . String freeQuery) 



27 



Sets the free query part. 
Parameters: 

f reeQuery - the free query part (can be null) 



5 1.1.6.57 addValueFields 

public void addValueFields ( ValueFields constraint) 
Adds a value/fields constraint. 
Parameters: 

constraint - the value/fields constraint 
10 — 

1 .1 .6.58 getValueFields 

public java.util. Collection getValueFields ( ) 
Provides the value/fields constraints. 
Returns: 

1 5 the value/fields constraints (empty, but never null) 



1.1.6.59 addField 

public void addField ( Field field) 

Deprecated, use value/fields object and free query value 
20 Adds a field id to the search constraints. If the field is already in the constraints, this 

methods does nothing but does not complain. 
Parameters: 
field -the field 



25 1.1.6.60 removeField 

public void removeField ( Field field) 

Deprecated, use value/fields object and free query value 

Removes a field id from the search constraints. If the field is not in the contraints, this 
method does nothing but does not complain. 
30 Parameters: 

field -the field 



1.1.6.61 getFields 

public java.util. Set getFields () 
35 Deprecated, use value/fields object and free query value 

Provides the set of fields used to constrain the search. 
Returns: 

the set of field ids used to constrain the search; may be null 



40 1.1.6.62 getValue 

public java.lang. String getValue () 

Deprecated, use value/fields object and free query value 

Provides the value to search for. 

Returns: 
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the value to search for 



1.1.6.63 setValue 

public void setValue (java . lang . String value) 

Deprecated, use value/fields object and free query value 

Sets the value to search for. 

Parameters: 

value - the value to search for 



1.1.6.64 isFieldUnion 

public boolean isFieldUnion ( ) 

Deprecated, use value/fields object and free query value 

Provides the field union. 

Returns: 

true if any matching fields product a result, false if all fields must match for a result 



1.1.6.65 setFieldUnion 

public void setFieldUnion (boolean fieldUnion) 

Deprecated, use value/fields object and free query value 

Sets the field union. 

Parameters: 

fieldUnion - true if any matching fields product a result, false if all fields must match 
for a result 



1 .1 .6.66 addlndexValue 

public void addlndexValue (Index index, 

java . lang. String value) 
Adds an index to constrain the search. 
Parameters: 
index - the index 
value - the value for the index 



1.1.6.67 getlndices 

public java .util .Map getlndices () 
Provides the index values. 
Returns: 

the index constraints 



1.1.6.68 toString 

public java . lang. String toString () 

Provides a string representation of this object. 
Overrides: 

toString in class java . lang. Object 
Returns: 

a string representation of this object 
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1 . 1 .7 Class MissingResourceException 

java . lang. Object 

1 

O +-- java. lang. Throwable 

i 

+ - - j ava . lang . Exception 

i 

+- - com. concept is . cms . CmsException 

o I 

+- -com. concept is . cms .MissingResourceException 
All Implemented Interfaces: 

java.io.Seriaiizable 



1 5 public class MissingResourceException 

extends CmsException 

Indicates that an attempt was made to access a non-existant resource. 

See Also: 

Serialized Form 

20 ============= 

Constructor Summary | 

MissingResourceException ( ) 

Creates a new instance of MissingResourceException without detail message. 
MissingResourceException ( j ava . lang . String msg) 

Constructs an instance of MissingResourceException with the specified detail 
message. 

MissingResourceException (java . lang. String msg, java . lang. Throwable cause) 

Constructs an instance of MissingResourceException with the specified detail 
message. 

MissingResourceException ( j ava . lang . Throwable cause) 

Creates a new instance of MissingResourceException without detail message. 



Methods inherited from class java.lang.Throwable 

f illlnStackTrace, getCause, getLocalizedMessage , getMessage, getStackTrace, 
initCause, printStackTrace, printStackTrace , printStackTrace, setStackTrace, 
toString 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 
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Constructor Detail 



1 .1 .7.1 MissingResourceException 
public MissingResourceException ( ) 

Creates a new instance of MissingResourceException without detail message. 



1 . 1 .7.2 MissingResourceException 

public MissingResourceException ( j ava . 1 an n . Strin^ ms^) 

Constructs an instance of MissingResourceException with the specified detail 

message. 
Parameters: 

msg - the detail message. 



1 .1 .7.3 MissingResourceException 

public MissingResourceException (j ava. lang. Throwable cause) 

Creates a new instance of MissingResourceException without detail message. 

Parameters: 

cause - the root cause of the exception 



1 A .7.4 MissingResourceException 

public MissingResourceException (java. lang. String msg, 

j ava . lang. Throwable cause) 

Constructs an instance of MissingResourceException with the specified detail 

message. 
Parameters: 

msg - the detail message. 

cause - the root cause of the exception 

1 .1 .8 Class MissingResourceException 

j ava . lang . Ob j ect 

i 

+ -- java . lang. Throwable 

I 

+ - - j ava . lang . Except ion 

i 

+- - com, concept is . cms . CmsException 

+- -com. concept is .cms .MissingResourceException 
All Implemented Interfaces: 

j ava. io. Serializable 



public class MissingResourceException 

extends CmsException 



Indicates that an attempt was made to access a non-existant resource. 
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See Also: 

Serialized Form 



[Constructor Summary 

MissingResourceExceptlon ( ) 

Creates a new instance of MissingResourceException without detail message. 
MissingResourceException ( j ava . lang . String msg) 

Constructs an instance of MissingResourceException with the specified detail 
message. 

MissingResourceException ( j ava . lang . String msg. j avs i. lang . Throwable cause) 

Constructs an instance of MissingResourceException with the specified detail 
message. 

MissingResourceException ( j ava . lang . Throwable cause) 

Creates a new instance of MissingResourceException without detail message. 



Methods inherited from class java.lang.Throwable 

f illlnStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 
ini tCause , printStackTrace , prints tackTrace , prints tackTrace , se tS tackTrace , 
toString 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 



Constructor Detail 

1 .1 .8.1 MissingResourceException 
public MissingResourceException () 

Creates a new instance of MissingResourceException without detail message. 



1.1 .8.2 MissingResourceException 

public MissingResourceException (j ava . lang. String msg) 

Constructs an instance of MissingResourceException with the specified detail 

message. 
Parameters: 

msg - the detail message. 
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1 .1 .8.3 MissingResourceException 

public MissingResourceException ( java . lang. Throwable cause) 

Creates a new instance of MissingResourceException without detail message. 

Parameters: 

cause - the root cause of the exception 



1 .1 .8.4 MissingResourceException 

public MissingResourceException(java.lang.String msg, 

java . lang. Throwable cause) 

Constructs an instance of MissingResourceException with the specified detail 

message. 
Parameters: 

msg - the detail message. 

cause - the root cause of the exception 

1.1.9 Class ModifiedResourceException 

j ava . lang . Ob j ect 

i 

+ - - j ava . lang . Throwable 

i 

+-- java . lang. Exception 

i 

+- - com. concept is . cms . CmsException 

+ - - com . concep tis . cms .ModifiedResourceException 
AH Implemented Interfaces: 

j ava. io . Serializable 



public class ModifiedResourceException 

extends CmsException 

Indicates that a resource has been modified since it was last accessed. 

See Also: 

Serialized Form 



Constructor Summary 

J . . 

ModifiedResourceException ( ) 

Creates a new i nstance of ModifiedResourceException without detail message. 
ModifiedResourceException ( 1 ava . lang . String msg) 

Constructs an instance of ModifiedResourceException with the specified detail 
message. 

ModifiedResourceException (java . lang . String msg, java . lang . Throwable cause) 

Constructs an instance of ModifiedResourceException with the specified detail 
message. 

ModifiedResourceException ( j ava . lang . Throwable cause) 

Creates a new instance of ModifiedResourceException without detail message. 
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Methods inherited from clas s java.lang.Throwable 

f illlnStackTrace, getCause, getLocalizedMessage , getMessage, getStackTrace, 
initCause, prints tackTrace, printStackTrace , printStackTrace, setStackTrace, 
toString 



Methods inherited from class java. la ng. Object 

clone, equals, finalize, getclass, hasncode, notify, notifyAll, wait, wait, 
wait 



[Constructor Detail 

1 .1 .9.1 ModifiedResourceException 
public ModifiedResourceException () 

Creates a new instance of ModifiedResourceException without detail message. 



1 .1 .9.2 ModifiedResourceException 

public Modif iedResourceException (java. lang. String msg) 

Constructs an instance of ModifiedResourceException with the specified detail 

message. 
Parameters: 

msg - the detail message. 



1 .1 .9.3 ModifiedResourceException 

public Modif iedResourceException (java.lang.Throwable cause) 

Creates a new instance of ModifiedResourceException without detail message. 

Parameters: 

cause - the root cause of the exception 



1 .1 .9.4 ModifiedResourceException 

public ModifiedResourceException (java. lang. String msg, 

java.lang.Throwable cause) 

Constructs an instance of ModifiedResourceException with the specified detail 

message. 
Parameters: 

msg - the detail message. 

cause - the root cause of the exception 
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1.1.10 Class ValueFields 

j ava . lang . Ob j ec t 

i 

+ - -com. conceptis . cms .ValueFields 



public class ValueFields 

extends java.lang.Object 

Stores a string value and a collection of fields. 



Sri' : ■ — — ~— 

Field Summary 


private 
java.util .Collection 


fields I 
The collection of fields. 


private 
j ava . lang . String 


value 

The value. 




Construct 


or Summary 


ValueFields ( ) 








java.util .Collection 


getFields () 

Provides the fields. 


j ava . lang . String 


getValue ( ) 

Provides the value. 


void; 


setFields (iava.util .Collection fields) 

Sets the fields. 


void 


setValuehava.lana.Strina value) 
Sets the value. 


j ava . lang . String 


toString () 

Provides a String representation of the constraint. 



Methods inherited from class java.lang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 
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Field Detail 



1.1.10.1 value 

private java . lang . String value 
The value. 



5 1.1.10.2 fields 

private java .util .Collection fields 
The collection of fields. 





Constructor Detail 


1.1.10.3 ValueFields 








public ValueFields ( ) 








Method Detail 


■ <:>: .. . . .,• ■ • . :~. " - ' ■ . : . 







10 1.1.10.4 getValue 

public java . lang. String getValue () 
Provides the value. 
Returns: 
the value 

15 

1.1.10.5 setValue 

public void setValue (j ava . lang . String value) 
Sets the value. 
Parameters: 
20 value - the value to search for 



1.1.10.6 getFields 

public java .util . Collection getFields () 
Provides the fields. 
25 Returns: 

the fields to search through 



1.1.10.7 setFields 

public void setFields ( java . util . Collection fields) 
30 Sets the fields. 

Parameters: 

fields - the fields to search for 



1.1.10.8 toString 
35 public java . lang. String toString () 

Provides a String representation of the constraint. 
Overrides: 
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toString in class java. lang. Object 
Returns: 

a string representation of the constraint 
1.1.11 Interface BinaryContent 



public interface BinaryContent 

Data holding class to store information on the binary content associated with an item. 



Method Summary 


int 


getContentLength ( ) 

Get the content length of the input binary stream obtained. 


j ava . io . Inputs tream 


ge tCont en t Stream ( ) 

Get the content of the input binary stream obtained. 


java . lang. String 


ge tMimeType ( ) 

Get the MIME type of the input binary stream obtained. 
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Method Detail 



1.1.11.1 getContentLength 

public int getContentLength ( ) 

Get the content length of the input binary stream obtained. 

Returns: 

1 5 the length of the binary content 



1 .1 .1 1 .2 getMimeType 

public java. lang. String getMimeType ( ) 

Get the MIME type of the input binary stream obtained. 
20 Returns: 

the MIME type of the binary content. 



1.1.11.3 getContentStream 

public java . io. Input St ream getContentStream ( ) 
25 Get the content of the input binary stream obtained. 

Returns: 

an inputstream connected to the binary content. 

1.1.12 Interface CmsUser 

30 All Super interfaces: 

Obi ectWithPrimarvKe v 
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public interface CmsUser 
extends Obi ectWithPrimarvKe v 

A cmsuser is the end-user of the Content Management System, the actual user of the 
5 administration interface, or the user of the web site etc. 



Method Summary 


void 


addCmsUserGroup (CmsUserGrouD userGrouo) 


Adds the user to the specified cmsuser Group 


java.util.Set 


getCmsUserGroups ( ) 

Returns a Set Of all the PmpsTTci R"rf^"ro"n-n<3 nfwhipVi tViic PmotTaar- ic a 

member. 


java .util . Set 


getCollec tions { ) j 
Returns a set of all the collections that this user has access to. 


j ava . lang . String 


getEmail ( ) 

Returns the email of this cmsuser. 


j ava . lang . String 


getFirstName ( ) 

Returns the first name of this cmsuser. 


j ava . lang . String 


getLastName () 

Returns the last name of this cmsuser. 


j ava . lang . String 


getPassword () 

Returns the password of this Cmsuser. 


j ava . lang . String 


get User name ( } 

Returns the username of this Cmsuser. 


boolean 


fisActive () 

Indicates whether the user is active. 


void 


removeCms User Group (Cms User Group userGroup) 


Removes the user from the specified cmsUserGroup 


void 


setActive (boolean active) 

Sets whether the user is active. 


void 


setEmail (iava . lancr. Strina email) 
Sets the email of this cmsuser. 


void 


setFirstName (iava . lana . Strina f irstName) 

Sets the first name of this Cmsuser. 


void 


setLastName (iava. lana. Strina lastName) 
Sets the last name of this cmsuser. 


void 


setPassword (iava. lana. Strina oassword) 
Sets the password of this Cmsuser. 


void 


setUsername (iava . lang. String username) 
Sets the username of this Cmsuser. 
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Methods inherited from interface com.conceptisxms . ObiectWithPrimarvKev 

get Pr ima ry Key 



Method Detail 



1.1.12.1 setUsername 

public void setTXsername (java . lang. String username) 
throws AuthorizationExcept-ion ,- 
5 ConnectionException 
Sets the username of this CmsUser. 
Parameters: 

username - the name of this CmsUser 
Throws: 

1 0 AuthorizationException - if the current user does not have permission to perform 

this operation 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

15 - ___ 

1 . 1 . 1 2.2 getUsername 

public java . lang. String getUsername ( ) 

throws AuthorizationException , 
Connect ionExcep t ion 
20 Returns the username of this CmsUser. 

Returns: 

the username of this cms user 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
25 this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



30 1 .1 .12.3 setPassword 

public void setPassword (java . lang. String password) 
throws AuthorizationException , 
ConnectionException 
Sets the password of this CmsUser. 
35 Parameters: 

password - the password of this CmsUser. 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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Conne c t i onBxc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



5 1.1.12.4 getPassword 

public java.lang. String getPassword ( ) 

throws AuthorizationException , 
Connect ionExcept ion 
Returns the password of this cmsuser. Note that some implementations may throw an 
1 0 unsupportedOperationException if it is not possible to retreive a user's password 

from the data repository. 
Returns: 

the password of this cmsuser; this may be null 
Throws: 

1 5 AuthorizationException - if the current user does not have permission to perform 

this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.5 setFirstName 

public void setFirstName (java . lang . String firstName) 
throws Author i zat ionExcept ion , 
Connect ionExcept ion 
Sets the first name of this Cmsuser. 
Parameters: 

firstName - the first name of this Cmsuser 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

Connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



35 1.1.12.6 getFirstName 

public java. lang. St ring getFirstName { ) 

throws AuthorizationException , 
Connect ionExcept ion 
Returns the first name of this cmsuser. 
40 Returns: 

the first name of this cmsuser 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

45 connect ionExcept ion - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 
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30 



40 



1.1.12.7 setLastName 

public void setLastName (java . lang. String lastName) 
throws Au thor i zat ionExcept ion , 
ConnectionException 
Sets the last name of this Cmsuser. 
Parameters: 

lastName - the last name of this cmsuser 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 

be thrown if the Hrivpr imnlpm mtntinn ^Viqo^o tr\ ncp A^f^r-^^A A~+^ l^nAi*** Sr~~ 
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performance reason). 



1.1.12.8 getLastName 

public java. lang. String getLastName ( ) 

throws Authori zat ionExcept ion , 
ConnectionException 
Returns the last name of this Cmsuser. 
Returns: 

the last name of this cmsuser 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.9 setEmail 

public void setEmail (java . lang . String email) 
throws AuthorizationException , 
C onn e c t i onExc ep t i on 
Sets the email of this cmsuser. 
Parameters: 

email - the email of this CmsUser 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.10 getEmail 

public java. lang. String getEmail () 

throws AuthorizationException , 
ConnectionException 
Returns the email of this cmsuser. 
Returns: 
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the email of this cmsuser 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.11 getCmsUserGroups 

public java.util .Set getCmsUserGroups ( ) 

*- Vi-vr^T.Kt A -i ■. V» -v- -! ~* «- -J m,- i- J 

Connect ionExcept ion 
Returns a set of all the cmsuser Groups of which this cmsuser is a member. 
Returns: 

a Set of all the cmsUserGroups of which this Cmsuser is a member 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.12 addCmsUserGroup 

public void addCmsUserGroup ( CmsUserGroup userGroup) 

throws Authorizat ionException , 
Connec t i onExc ep t i on 
Adds the user to the specified Cmsuser Group 
Parameters: 

userGroup - the user group to add 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.13 removeCmsUserGroup 

public void removeCmsUserGroup ( CmsUserGroup userGroup) 

throws AuthorizationException , 
Connec t ionExcept ion 
Removes the user from the specified CmsUserGroup 
Parameters: 

userGroup - the user group to remove 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.14 getCollections 

public java.util.Set getCollections ( ) 

throws Authori za t ionExcept ion , 
ConnectionException 
Returns a set of all the Collections that this user has access to. 
Returns: 

the set of collections that the user has access to 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.15 isActive 

public boolean isActive () 

throws AuthorizationException , 
ConnectionException 
Indicates whether the user is active. Inactive user's are restricted in the actions they 
may perform. 
Returns: 

true if the user is active, false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.12.16 setActive 

public void setActive (boolean active) 

throws AuthorizationException , 
ConnectionException 
Sets whether the user is active. Inactive user f s are restricted in the actions they can 
perform. 
Parameters: 

active - true if the user is active, false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 
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1.1.13 Interface CmsUserFactory 



public interface CmsUserFactory 

Interacts with the CMS to provide access to users of the CMS. 



Method Summary 


CmsUser 


createNewCmsUser ( ) 

Creates a new CmsUser instance, uninitialized, not stored in the CMS. 


void 


deleteCmsUser (CmsUser cmsUser) 
Deletes this CmsUser. 


CmsUser 


getCmsXJser (com. concept is . util . PrimaryKev key) 
Provides the CmsUser with the specified key 


CmsUser 


getCmsUser ( java . lanq. Strinq username) 

Provides the CmsUser with the specified username. 


java.util.Set 


getCmsUsers ( ) 

Provides the set of all Cmsusers in the CMS. 


void 


savednsUser (CmsUser cmsUser) 
Saves the specified CmsUser. 



Method Detail lii • 

-E^^^M ; ^ . . i ^ 7 ... : " , ? ^ :__ . : 



1.1.13.1 getCmsUsers 

public java.util.Set getCmsUsers ( ) 

throws Connect ionExcept ion , 
10 Author izat ionExcept ion 

Provides the set of all cmsusers in the CMS. 
Returns: 

the set of all cmsusers (may be empty but never null) 
Throws: 

1 5 connect ionException - if there is a problem interacting with the CMS 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 



1.1.13.2 getCmsUser 
20 public CmsUser getCmsUser (com. concept is .util . Primary Key key) 

throws Connect ionExcept ion , 

Authorizat ionExcept ion , 
MissingResourceException 
Provides the CmsUser with the specified key 
25 Parameters: 

key - the primary key of the CmsUser 
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Returns: 

the cmsuser with the specified key 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the Cmsuser specified by the key does not exist 



1.1.13.3 getCmsUser 

public CmsUser getCmsUser (java . lang. String username) 

t hr ow s Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Provides the cmsuser with the specified username. 
Parameters: 

username - the username being searched for 
Returns: 

the cmsuser with the specified username 
Throws: 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the CmsUser specified by the key does not exist 



1 . 1 . 1 3.4 createNewCmsUser 

public CmsUser createNewCmsUser ( ) 

Creates a new cmsuser instance, uninitialized, not stored in the CMS. Once correctly 

initialized, this instance may then be inserted in the CMS using the 

saveCmsUser (com. conceptis . cms . CmsUser) method. 

Returns: 

the newly created cmsuser 



1.1.13.5 saveCmsUser 

public void saveCmsUser ( CmsUser cmsUser) 

throws Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Saves the specified CmsUser. This will change the cmsuser f s entry in the CMS to 
reflect the state of the cmsuser parameter. 
Parameters: 

cmsuser - the <CODECMSUSER< code>to insert/update 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing Cmsuser does not exist any 
longer 
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1.1.13.6 deleteCmsUser 

public void deleteCmsUser ( CmsUser cmsUser) 

throws Connect ionExcept ion , 

AuthorizationException , 
5 MissingResourceException 

Deletes this CmsUser. This may have unintended consequences. Note that some 
implementations may throw an unsupportedOperationException if the deletion of 
CmsUsers is not possible. 
Parameters: 
10 cmsUser - the CmsUser to delete 

Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

1 5 MissingResourceException - if the CmsUser does not exist any longer 

1.1.14 Interface CmsUserGroup 

All Superinterfaces: 

Obi ectWithPrimarvKe v 

20 

public interface CmsUserGroup 

extends Obi ectWithPrimarvKe v 

A CmsUserGroup is used to grant security-related permissions to a group of CmsUser s. 



Method Summary 


? 

void 


addCmsUser (CmsUser cmsUser) 

Registers the given CmsUser as a member of this CmsUserGroup. 


java .util . Set 


getCmsUsers () 

Returns a set of all the CmsUsers that are registered as member of 
this CmsUserGroup. 


java .util . Set 


getCollections () 

Provides the set of collections that this group has access to. 


j ava . lang . String 


getName ( ) 

Returns the name of this CmsUserGroup. 


void 


removeCmsUser (CmsUser cmsUser) 

Unregisters the given CmsUser as a member of this CmsUserGroup. 


void 


setNamo ( java . lancf. strinq name) 

Sets the name of this CmsUserGroup. 
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[Methods inherited from interface com.eonceptis.cms. ObiectWithPrimarvKev 

getPrimaryKey 
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Method Detail 



1.1.14.1 setName 

public void setName (java . lang. String name) 
throws AuthorizationException , 
ConnectionException 
Sets the name of this CmsUserGroup. 
Parameters: 

name - the name of this Cms user Group 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.14.2 getName 

public java. lang. String getName () 

throws AuthorizationException , 
ConnectionException 
Returns the name of this CmsUserGroup. 
Returns: 

the name of this CmsUserGroup 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.14.3 addCmsUser 

public void addCmsUser ( CmsUser cmsUser) 

throws AuthorizationException , 
ConnectionException 
Registers the given CmsUser as a member of this CmsUserGroup. 
Parameters: 

cmsUser - the CmsUser to register as a member of this CmsUserGroup 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 
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1.1.14.4 removeCmsUser 

public void removeCmsUser ( CmsUser cmsUser) 

throws Au thor i zat ionExcept ion , 
Connect ionException 
Unregisters the given CmsUser as a member of this cms user Group. 
Parameters: 

cmsuser - the CmsUser to unregister as a member of this cmsuserGroup 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 

be thrown if the Hriver imnlpmpntatmn rhr\cf*c tn nc*» At±f(*vrt*A Ao+r> 
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performance reason). 



1 .1 .14.5 getCmsUsers 

public java.util.Set getCmsUsers ( ) 

throws Authori zat ionExcept ion , 
Connect ionExcept ion 
Returns a set of all the CmsUsers that are registered as member of this CmsuserGroup. 
Returns: 

a Set of all the CmsUsers that are registered as member of this CmsuserGroup 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.14.6 getCollections 

public java.util.Set getCollections ( ) 

throws AuthorizationException , 
ConnectionException 

Provides the set of collections that this group has access to. 
Returns: 

the set of collections that this group has access to 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

1.1.15 Interface CmsUserGroupFactory 



public interface CmsUserGroupFactory 

A CmsUserGroupFactory interacts directly with the CMS server to perform any action that 
creates, modifies, deletes or simply loads the data of the cmsUserGroups. 
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Method Summary 


CmsUserGroup 


createNewCmsUserGroup ( ) 




Creates a new CmsUserGroup instance, uninitialized, not stored in the 

CMS. 


void 


deleteCmsUserGroup (CmsUserGroup CmsUserGroup) 


Deletes this CmsUserGroup. 


CmsUserGroup 


getCmsUserGroup (com. concept is . util . PrimarvKev Jcev) 




Provides the CmsUserGroup with the specified key. 


•A 11T-1 llf> j 1 P«»- 

juvu . ui — i. j» . oc= u 


^stduoUscrGroupo ( } 

Returns a Set containing all the cmsUserGroups defined in our CMS. 


void 


saveCmsUser Group (CmsUserGroup CmsUserGroup) 


Saves the specified CmsUserGroup. 



Method Detail 

1.1.15.1 getCmsUserGroups 

public java. util .Set getCmsUserGroups ( ) 

throws Conne c t i onE xc ep t i on , 

AuthorizationException 
Returns a set containing all the CmsUserGroups defined in our CMS. 
Returns: 

a set of all CmsUserGroups (may be empty but never null) 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 



1.1.15.2 getCmsUserGroup 

public CmsUserGroup getCmsUserGroup (com. conceptis .util . PrimaryKey key) 

throws Connect ionExcept ion , 

Authori zat ionExcept ion , 
MissingResourceException 
Provides the CmsUserGroup with the specified key. 
Parameters: 

key - the primary key of the CmsUserGroup 
Returns: 

the CmsUserGroup with the specified key 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the CmsUserGroup specified by the key does not exist 
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1.1.15.3 createNewCmsllserGroup 

public CmsUserGroup createN wCms User Group ( ) 

Creates a new CmsUserGroup instance, uninitialized, not stored in the CMS. Once 
correctly initialized, this instance may then be inserted in the CMS using the 
saveCmsUserGroup (com. concept is . cms . CmsUserGroup) method. 
Returns: 

the newly created CmsUserGroup 



1 .1 .1 5.4 saveCmsUserGroup 

public void saveCmsUserGroup ( CmsUserGroup CmsUserGroup) 

throws Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Saves the specified CmsUserGroup. This will change the cmsuserGroup's entry in the 
CMS to reflect the state of the CmsUserGroup parameter. 
Parameters: 

CmsUserGroup - the CmsUserGroup to insert/update 
Throws: 

Connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing CmsUserGroup does not exist 
any longer 



1 .1 .1 5.5 deleteCmsUserGroup 

public void deleteCmsUserGroup ( CmsUserGroup CmsUserGroup) 

throws Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Deletes this CmsUserGroup. This may have unintended consequences. Note that some 
implementations may throw an unsupportedOperationException if the deletion of 
cmsuserGroups is not possible. 
Parameters: 

CmsUserGroup - the CmsUserGroup to delete 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the user does not have permission to perform this 
operation 

Miss ingRe sour ceExcep t i on - if the CmsUserGroup does not exist any longer 

1.1.16 Interface Collection 
All Superinterfaces: 

ObiectWithPrimarvKev 



public interface Collection 
extends Obi ect WithPrimarvKe v 
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A collection is used to regroup several item s together, and can be used to globally assign 
security properties. 



Method Summary 


void 


addGroupAccess (CmsUserGroup group) 

A HH C Q OTYMlT*> tTinf Vide qpppcc tr\ fViio r> r\l^ f*r>+i r\r^ 

auuj <x giuup nidi nas access 10 mis collection. 


void 


addltem(ltem item) 

Anne o n i tpm fr\ /"»/~\ 1 1 /"v-m 

/iuu& an liem 10 mis cou ecu on. 


void 


addUserAccaas (Cms User userToAdd) 

^vuus a user indi nas access 10 inis conecnon. 


java .util . Set 


getCmsUsers () 

rroviaes tne set or cmsusers tnat nave access to this collection. 


java . util . Set 


getGroups ( ) 

Provides tHe set of Proline tnat riavp arrpQ^ tn tViiQ cr\X\F>oi\rxr\ 


java .util . Set 


getltems () 

Provides the set of items that are present in this collection. 


j ava . lang . String 


getName () 

Returns the name of this collection. 


void 


removeGroupAccess (CmsUserGroup group) 


Removes a group from the access list of this collection. 


void 


removeltemdtem item) 

Removes an item from this collection. 


void 


removeUser Access (CmsUser userToRemove) 

Removes a user from the access list of this collection. 


void 


setName (java . lanq . Strina name) 

Sets the name of this collection. 



Methods inherited from interface com.conceptis.cms,ObiectWithPrimarvKev 



[ get PrimaryKey 



Method Detail 

„.„ . _ _ - x ; V i .. ■• ... 

1.1.16.1 setName 

public void setName (java . lang. String name) 
throws AuthorizationException , 
ConnectionException 
1 0 Sets the name of this Collection. 

Parameters: 

name - the name of this collection 
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Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne ctionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.16.2 getName 

public java.lang. String getName () 

throws AuthorizationException , 
Connect ionExcept ion 

Returns the name of this Collection. 
Returns: 

the name of this collection 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 .1 .16.3 addGroupAccess 

public void addGroupAccess ( Cms User Group group) 

throws AuthorizationException , 
Connect ionExcept ion 
Adds a group that has access to this collection. If the group already has access to this 
collection, this method will do nothing, but will not complain. 
Parameters: 

group - the group to add to the access list of this collection 
Throws: 

Author i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.1 6.4 removeGroupAccess 

public void removeGroupAccess ( CmsUserGroup group) 

throws AuthorizationException / 
Connec t i onExc ep t i on 
Removes a group from the access list of this collection. If the group did not have 
access to this collection, this method will do nothing, but will not complain. 
Parameters: 

group - the group to remove from the access list of this collection 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.16.5 getGroups 

public java.util.Set getGroups () 

throws Author! zationExcept ion , 
Connect ionExcept ion , 
Mi s singResourceExcep t ion 
Provides the set of groups that have access to this collection. 
Returns: 

the set of the code>CmsGroups that have access, in no particular order 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - if the groups cannot be accessed 



1.1.16.6 addUserAccess 

public void addUserAccess ( CmsUser userToAdd) 

throws Authorizat ionExcept ion , 
ConnectionException 
Adds a user that has access to this collection. If the user already has access to this 
collection, this method will do nothing, but will not complain. 
Parameters: 

userToAdd - the user to add to the access list for this collection 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.16.7 removeUserAccess 

public void removeUserAccess ( CmsUser userToRemove) 

throws Authorizat ionExcept ion , 
Connect ionExcept ion 
Removes a user from the access list of this collection. If the user did not have access to 
this collection, this method will do nothing, but will not complain. 
Parameters: 

userToRemove - the user to remove from the access list of this collection 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 
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ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.16.8 getCmsUsers 

public java.util.Set getCmsUsers ( ) 

throws Author i zat ionExcep t ion , 
ConnectionException , 
MissingResourceException 
Provides the set of cmsusers that have access to this collection. 
Returns: 

the set of the users that have access, in no particular order 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t ionExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - if the users cannot be accessed 



1.1.16.9 addltem 

public void addltem ( Item item) 

throws AuthorizationException , 
ConnectionException 
Adds an item to this collection. If the item was already in the collection, this method 
will do nothing, but will not complain 
Parameters: 

item - the item to add to this collection 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.16.10 removeltem 

public void removeltem ( Item item) 

throws Author i za t ionExcept ion , 
ConnectionException 
Removes an item from this collection. If the item was not in the collection, this method 
will do nothing, but will not complain. 
Parameters: 

item - the item to remove from this collection 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.16.11 getl terns 

public java.util.Set getltemsO 

throws Authorizat ionException , 
Connect ionException 
Provides the set of items that are present in this collection. 
Returns: 

the set of the items in the collection, in no particular order 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

1.1.17 Interface CollectionFactory 



public interface CollectionFactory 

Interacts with the CMS to provide access to collections of the CMS. 



Method Summary 



rill 



Collection 


createNewCollection { ) 




Creates a new collection instance, uninitialized, not stored in the 

CMS. 


void 


deleteCollection (Collection collection) 


Deletes this collection. 


Collection 


getCollection (com. conceptis .util .PrimarvKev kev) 
Provides the collection with the specified key. 


java.util . Set 


getCollections ( ) 

Provides the set of all Collections. 


void 


saveCollection (Collection collection) 
Saves the specified collection. 



Method Detail 

1 . 1 . 1 7. 1 getCollections 

public java.util.Set getCollections { ) 

throws Connect ionExcept ion , 



55 



AuthorizationException 

Provides the set of all Collections. 
Returns: 

the set of all Collection (may be empty but never null) 
Throws: 

c onne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 



1.1.17.2 getCollection 

public Collection getCollection (com. concept is . util . PrimaryKey key) 

throws ConnectionException , 

AuthorizationException , 
MissingResourceException 
Provides the collection with the specified key. 
Parameters: 

key - the primary key of the collection 
Returns: 

the collection with the specified key 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

Miss ingRe sour ceExcept ion - if the Collection specified by the key does not exist 



1 .1 . 1 7.3 createNewCollection 

public Collection createNewCollection ( ) 

Creates a new collection instance, uninitialized, not stored in the CMS. Once 
correctly initialized, this instance may then be inserted in the CMS using the 
saveCollection (com. conceptis . cms . Collection) method. 
Returns: 

the newly created collection 



1.1.17.4 saveCollection 

public void saveCollection ( Collection collection) 

throws Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Saves the specified collection. This will change the collection's entry in the CMS 
to reflect the state of the collection parameter. 
Parameters: 

collection - the Collection to insert/update 
Throws: 

ConnectionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing Collection does not exist any 
longer 
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1 .1 . 1 7.5 deleteCollection 

public void deleteCollection ( Collection collection) 

throws Connect ionExcept ion , 
5 Authorizat ionExcept ion , 

MissingResourceException 
Deletes this collection. This may have unintended consequences. Note that some 
implementations may throw an unsupportedOperationException if the deletion of 
collections is not possible. 
1 0 Parameters: 

collection - the Collection to delete 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
Authorizat ionExcept ion - if the user does not have permission to perform this 
1 5 operation 

Mi s s ingRe sour ceExcept ion - if the Collection does not exist any longer 

1.1.18 Interface Connection 



20 public interface Connection 

Provides access to factories that can be used to interact with the CMS. 



Method Summary 


void 

I 
i 


clearCaches ( ) 

Clears the caches of all factories. 


void 


close ( ) 

Closes the connection. 


com. concept is . util . PrimaryKey 


createPrimaryKey ( i ava . lancr . Strina kev) 
This method returns a PrimaryKey of the 
appropriate type. 


CmsUserFactory 


getCmsUserFactory ( ) 




Provides a CmsUserFactory that utilizes this 
connection. 


CmsUserGroupFactory 


getCmsUserGroupFactory ( ) 




Provides a CmsUserGroupFactory that utilizes 
this connection. 


Collect ionFactory 


getCollectionFactory ( ) 




Provides a coiiectionFactory that utilizes this 
connection. 


IndexFactory 


getlndexFactory ( ) 




Provides a IndexFactory that utilizes this 
connection. 


ItemFactory 


get ItemFactory ( ) 
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rioviaes a itemFactory tnat utilizes tms 
connection. 


I temType Factory 


getltemTypeFactory ( ) 




Provides a i temType Factory that utilizes this 
connection. 


CmsUser 


getOwner {) 

inis metnoa returns tne cmsuser associatea witn 
this connection. 


PublicationStatusFactory 


getPublicationStatusFactory ( ) 




Provides a PublicationFiowFactory that utilizes 
this connection. 


RelationTypeFactory 


getRelationTypeFactory ( ) 




i iuvitivo ct Keia u ion xyper acuory uidi uunzea 
this connection. 


java . lang. String 


getURLO 

This method provides the URL that was used to 
establish the connection. 


boolean 


isValidO 

This method returns true if this connection can 
still be used to connect to the CMS. 



Method Detail 

1.1.18.1 close 
public void close () 

throws Connect ionExcept ion 
5 Closes the connection. This frees up whatever resources were in use to interact with the 

CMS. 
Throws: 

conne c t i onExc ep t i on - if there is a problem closing the connection 



10 1.1.18.2 getCmsUserFactory 

public CmsUserFactory getCmsUserFactory ( ) 

Provides a CmsUserFactory that utilizes this connection. 
Returns: 

a factory for cmsusers. 
15 

1.1.18.3 getCmsUserGroupFactory 

public CmsUserGroup Factory getCmsUserGroupFactory ( ) 

Provides a cmsUserGroupFactory that utilizes this connection. 
Returns: 

20 a factory for cmsUserGroups. 
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1 . 1 . 1 8.4 getCollectionFactory 

public Collect ionFactory getCollectionFactory ( ) 

Provides a collectionFactory that utilizes this connection. 
Returns: 

a factory for Collections. 



1 . 1 .1 8.5 getltemFactory 

public ItemFactory getltemFactory ( ) 

Provides a ItemFactory that utilizes this connection. 
Returns: 

a factory for collections. 



1.1.18.6 getltemTypeFactory 

public ItemTypeFactory getltemTypeFactory ( ) 

Provides a ItemTypeFactory that utilizes this connection. 
Returns: 

a factory for CollectionTypes. 



1.1.18.7 getPublicationStatusFactory 

public PublicationStatusFactory getPublicationStatusFactory ( ) 
Provides a PublicationFiowFactory that utilizes this connection. 
Returns: 

a factory for PublicationFiows. 



1.1 .18.8 getRelationTypeFactory 

public RelationTypeFactory getRelationTypeFactory ( ) 

Provides a RelationTypeFactory that utilizes this connection. 
Returns: 

a factory for RelationTypes. 



1.1.18.9 getlndexFactory 

public IndexFactory getlndexFactory ( ) 

Provides a IndexFactory that utilizes this connection. 
Returns: 

a factory for indexes. 



1.1.18.10 isValid 

public boolean isValidO 

This method returns true if this connection can still be used to connect to the CMS. 

The validation procedure is driver-dependent, but must be very light (almost no data 

transfer) and fast, because this operation may be performed very often (by a pooling 

mechanism for example). 

Returns: 

true is this Connection is still valid; false otherwise. 
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1.1.18.11 getOwner 

public CmsUser getOwner () 

This method returns the Cmsuser associated with this connection. Since methods may 
throw AuthorizationExceptions depending on the security permissions for this user, 
it is useful for business logic to be able to preemptively know whether or not these 
operations will be successful prior to calling them. Using this method, this becomes 
possible. 
Returns: 

The cmsuser associated with this connection. 



1.1.18.12 createPrimaryKey 

public com.conceptis.util.PrimaryKey createPrimaryKey (java . lang . String key) 
This method returns a PrimaryKey of the appropriate type. Since PrimaryKeys will 
often be in a serialized form, this method allows the instantiation of the appropriate key 
type. 

Parameters: 

key - The string (serialized) representation of the primary key, typically received from 

a web application. 

Returns: 

The PrimaryKey associated with the specified parameter. 



1.1.18.13 getURL 

public java . lang. String getURLO 

This method provides the URL that was used to establish the connection. 
Returns: 

the URL used to establish the connection 



1.1.18.14 clearCaches 

public void clearCaches ( ) 

Clears the caches of all factories. 

1.1.19 Interface Driver 



public interface Driver 

Represents a driver for a CMS. The driver is able to provide Connection s to objects that 
request them, with the correct URL and set of credentials (username, password, etc - driver 
dependent information). 

A well behaved implementation of the Driver interface is expected to register itself with the 
DriverManager class when the class is first loaded. A failure to do this will result in the driver 
implementation being unavilable to the runtime environment. 



See Also: 
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DriverManager 



Method Summary 


boolean 


acceptsURL ( java . lana. Strinq url) 

Tests whether this driver understands the specified URL. 


Connection 


connect (java . lang. Strinq url, iava . util . Properties properties) 

Opens a connection to the specified URL. 



Method Detail 



1.1.19.1 connect 

5 public Connection connect (java . lang . String url, 

java .util . Properties properties) 
throws Connect ionException , 

Authent icationException , 
Author izat ionException 
1 0 Opens a connection to the specified URL. 

Parameters: 

uri - the url to open a connection to. 

properties - configuration options for the desired connection 
Returns: 

15 a connection to the CMS (null if it could not be opened) 

Throws: 

connect ionExcept ion - thrown if there is a problem 

Authent icationException - thrown if the username/password combination is invalid 
Authorizat ionExcept ion - if the site is inaccessible 

20 ____ ; 

1.1.19.2 acceptsURL 

public boolean acceptsURL (java . lang. String url) 

Tests whether this driver understands the specified URL. 
Parameters: 
25 url - the url to test 

Returns: 

true if the driver believes it can handle the url, false otherwise 

1.1.20 Interface Field 

30 All Superinterfaces: 

Obi ectWithPrimarvKe v 

public interface Field 

extends Obi ect Wi thPrimarvKe v 

35 A Field is an editable parameter. Their behavior are defined in itemType s (valid values, type, 
etc.), and the values are assigned when using an item . 
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Field Summary 


static int 


TYPE DATE 

Fields of type type_date hold an instance of java.util .Date. 


static int 


TYPE INTEGER 

Fields of type TYPE_INTEGER hold an instance of java. lang. Integer. 


static int 


TYPE PHONE NUMBER 

Fields of type type_phone_number hold an instance of 
j ava . lang . string that must respect a specific format. 


static int 


TYPE POSTAL CODE 

Fields of type type_postal_code hold an instance of java. lang. string 
that must respect a specific format. 


static int 


TYPE STRING 

Fields of type type_string hold an instance of java . lang. string with 
no specific constraint. 


static int 


TYPE URL 

Fields of type type_url hold an instance of java .net .url. 


static int 


TYPE XML I 

Fields of type type_xml hold an instance of java . lang. string that must 
be a valid XML string. 



Method Summary 


void 


addValidValue ( i ava . lana . Obi ect value ) 

Adds a new valid value for this Field definition. 


j ava . lang . Ob j ec t 


getDef aultValue ( ) 

Provides the default value for this Field definition. 


int 


getFieldType ( ) 

Returns the type of this Field. 


j ava . lang . String 


getHelpText () 

Provides the help text for the field, if available. 


java . lang . String 


get Name ( } 

Returns the name of this Field. 


int 


getOrder ( ) 

Provides the order of the field. 


int 


getPageO 

Provides the page number of the field, used for display purposes. 


j ava . lang . String 


ge tPageDescrip t ion ( ) 

Provides the name of the page the field is on. 


j ava . lang . String 


getServerName ( ) 

Provides the server name of this Field 


java.util .Set 


getValidValues () 
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Returns a set of all valid values defined for this Field. 


boolean 


isEditableO 

This feature is not supported in this version of the CMS API, and 
will always throw an UnsupportedOperationException. 


boolean 


isMandatory ( ) 

Indicates whether the field is mandatory. 


void 


removeValidValue (iava . lanq . Obi ect value) 

Removes a valid value for this Field definition. 


void 


setDef aultValue ( 1 ava . lanq . Obi ect value ) 

Sets the default value for this Field definition. 


void 


setEditable (boolean editable) 

This feature is not supported in this version of the CMS API, and 
will always throw an UnsupportedOperationException. 


void 


setFieldType (int newType) 

Stes the type of this Field. 


void 


setMandatory (boolean mandatory) 

Sets whether the field is mandatory or not. 


void 


setName(iava.lancr.Strina name) 
Sets the name of this Field. 


void 


setServerName ( java . lanq. Strincr name) 
Sets the name of this Field. 


boolean 


validateValue (j ava. lanq. Obi ect value) 

This helper method provides a way to validate a value before 
setting it in an item. 



| Methods inherited from interface com.conceptis.cms.ObiectWithPrimarvKev 

getPrimaryKey 



Field Detail 

1.1.20.1 TYPE_STRING 
public static final int TYPE_STRING 
5 Fields of type type_string hold an instance of java . lang . string with no specific 

constraint. 
See Also: 

Constant Field Values 



10 1.1.20.2 TYPEJNTEGER 

public static final int TYPE_INTEGER 

Fields of type type_integer hold an instance of java . lang . integer. 
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See Also: 

Constant Field Values 



1.1.20.3 TYPE_DATE 
5 public static final int TYPEDATE 

Fields of type type_date hold an instance of java .util .Date. 
See Also: 

Constant Field Values 



10 1.1.20.4 TYPEJJRL 

public static final int TYPE_TOL 

Fields of type type_url hold an instance of java .net .url. 
See Also: 

Constant Field Values 

15 — _ 

1.1.20.5 TYPE_PHONE_NUMBER 

public static final int TYPE_PHONE_NUMBER 

Fields of type type_phone_number hold an instance of java . lang . string that must 
respect a specific format. 
20 See Also: 

Constant Field Values 



1.1.20.6 TYPE_POSTAL_CODE 

public static final int TYPE_POSTAL_CODE 
25 Fields of type type_postal_code hold an instance of j ava . lang . string that must 

respect a specific format. 
See Also: 

Constant Field Values 



30 1.1.20.7 TYPE_XML 

public static final int TYPE_XML 

Fields of type type_xml hold an instance of java . lang. string that must be a valid 
XML string. 
See Also: 

35 Constant Field Values 

• — — — ~ _ — „ — . : — — — — •— — — , — — 

Method Detail 



1.1.20.8 setName 

public void setName (java . lang . String name) 
throws AuthorizationException , 
Connect ionExcept ion 
40 Sets the name of this Field. 

Parameters: 

name - the name of this Field 
Throws: 
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AuthorizationException - if the current user does not have permission to perform 
this operation 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.9 getName 

public java. lang. String getName () 

throws AuthorizationException , 
ConnectionException 

Returns the name of this Field. 
Returns: 

the name of this Field 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.10 getServerName 

public java. lang. String getServerName ( ) 

throws AuthorizationException , 
ConnectionException 

Provides the server name of this Field 
Returns: 

the server name of this field 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.11 setServerName 

public void setServerName (java . lang. String name) 

throws AuthorizationException , 
ConnectionException 
Sets the name of this Field. 
Parameters: 

name - the server name of this Field 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 
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1.1.20.12 isEditable 

public boolean isEditable () 

throws AuthorizationException , 
Connect ionExcept ion 

This feature is not supported in this version of the CMS API, and will always throw an 
UnsupportedOperat ionExcept ion. 

Indicates whether the field is editable. 

Returns: 

true if the field is editable, false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.13 setEditable 

public void setEditable (boolean editable) 

throws Authorizat ionExcept ion , 
Connect ionExcept ion 

This feature is not supported in this version of the CMS API, and will always throw an 
UnsupportedOperat ionExcept ion. 

Sets the editability of the field. 

Parameters: 

editable - true if the field should be editable, false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.14 isMandatory 

public boolean isMandatory ( ) 

throws AuthorizationException , 
Connect ionExcept ion 
Indicates whether the field is mandatory. 
Returns: 

true if the field is mandatory, false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



5 1.1.20.15 setMandatory 

public void setMandatory (boolean mandatory) 

throws AuthorizationException , 
Connect ionExcept ion 
Sets whether the field is mandatory or not. 
10 Parameters: 

mandatory - true if the field is mandatory, false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

1 5 conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.16 getFieldType 

public int getFieldType ( ) 

throws AuthorizationException , 
Connect ionExcept ion 
Returns the type of this Field. The returned value should be one of the defined 
Field. type xyz constants. 
Returns: 

an integer representing the type of field (see the Field . type xyz constants for the 

accepted values) 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



35 1.1.20.17 setFieldType 

public void setFieldType (int newType) 

throws AuthorizationException , 
Connect ionExcept ion 
Stes the type of this Field. The specified value should be one of the defined 
40 Field . type_xyz constants. 

Parameters: 

newType - integer representing the type of field(see the Field. type_jcyz constants for 

the accepted values) 

Throws: 

45 AuthorizationException - if the current user does not have permission to perform 

this operation 



20 



25 



30 
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connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.18 validateValue 

public boolean validateValue (java . lang .Object value) 

throws AuthorizationException , 
Connect ionExcept ion 
This helper method provides a way to validate a value before setting it in an item. It 
will check if the specified value respects the constraints set by this Field, such as the 

ClaSS. the Value itself (if it must Hp witVnr» » iv*ctn>WI cot rtf ollsviiro/4 t,n1,.on\ TU« 

- V w - ~ — ' ' — * vu« xwwu. kjwv WliV vr VU V U1UWO l 5 tit, A 11C 

set of valid values can be modified using addval idvalue ( j ava . lang . obi ec t ) and 
remove val idvalue ( j ava . lang . ob j ect ) . If no valid value is defined, then any value 
would be acceptable, unless this method disagrees for some other reason. 
Parameters: 

value - the object that may become the corresponding value in an item for this Field 

definition. 

Returns: 

true if the value respects the constraints defined by this Field definition 
Throws: 

AuthorizationException - if the user does not have permission to perform this 
operation 

connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.19 addValidValue 

public void addValidValue (java . lang. Object value) 

throws java . lang. UlegalArgumentException, 
AuthorizationException 
Adds a new valid value for this Field definition. This means that the 
val ida t eValue ( j ava . lang . obi ec t ) will only return true if the specified value 
equals one of the valid values defined through this method. 
Parameters: 

value - the valid value to add to the Set. 
Throws: 

java . lang . UlegalArgumentException - if the value parameter doesn't even respect 
the basic constraints of this Field definition (such a the Class) 
AuthorizationException - if the the user cannot access this information 



1.1.20.20 getValidValues 

public java. util. Set getValidValues ( ) 

throws AuthorizationException , 
Connect ionExcept ion 
Returns a set of all valid values defined for this Field. If empty, this means that any 
value respecting the basic constraints is acceptable. 
Returns: 

a set of all valid values defined for this Field. Can be emtpy but never null 
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Throws: 

Author i za t ionExcept ion - if the the user cannot access this information 
conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
5 performance reason). 



1.1.20.21 removeValidValue 

public void removeValidValue (java . lang .Object value) 

throws Author izat ionExcept ion 

Removes a valid value for this Field definition. If the value was the last one, then any 

value respecting the basic constraints will be acceptable. 

Parameters: 

value - the valid value to remove from the set. 
Throws: 

Authorizat ionExcept ion - if the the user cannot access this information 



1.1.20.22 getDefaultValue 

public java. lang. Object getDefaultValue ( ) 

throws AuthorizationExcept ion , 
Connect ionExcept ion 

Provides the default value for this Field definition. 
Returns: 

the default value for the field, possibly null 
Throws: 

Author i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.20.23 setDefaultValue 

public void setDefaultValue (java . lang .Object value) 

throws Author izat ionExcept ion 
Sets the default value for this Field definition. 
35 Parameters: 

value - the new default value 
Throws: 

AuthorizationExcept ion - if the current user does not have permission to perform 
this operation 

40 

1.1.20.24 getPage 
public int getPageO 

throws Authori zat ionExcept ion , 
Connect ionExcept ion 

45 Provides the page number of the field, used for display purposes. If it cannot be 

determined, a 0 is returned. 
Returns: 



10 



15 



20 



25 
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the page number of the field, 0 if it cannot be determined 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

5 connectionException - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

1.1.20.25 getOrder 

10 public int getOrder() 

throws AuthorizationException , 
Connect ionExcept ion 
Provides the order of the field. 
Returns: 
1 5 the order of the field 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
20 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 

1 . 1 .20.26 getPageDescription 

public java.lang. String getPageDescription ( ) 
25 throws AuthorizationException , 

ConnectionException 

Provides the name of the page the field is on. 
Returns: 

the name of the page 
30 Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
35 performance reason). 

1.1.20.27 getHelpText 

public java . lang. String getHelpText ( ) 

throws AuthorizationException , 
40 Conne c t i onExc ep t i on 

Provides the help text for the field, if available. 
Returns: 

the help text for the field 
Throws: 

45 AuthorizationException - if the current user does not have permission to perform 

this operation 
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Connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

1.1.21 Interface Index 
All Super interfaces: 

Obi ectWithPrimarvKe v 



public interface Index 

extends Obi ectWithPrimarvKe v 

An index represents a categorization tool used on a branch. 



Method Summary 


j ava . lang . String 


getDef aultValue ( ) 

Provides the default value of this index. 


java . lang .String 


get Name ( ) 

Provides the name of the index. 


java .util . Set 


getValidValues {) 

Provides the valid values of this index. 


boolean 


IsMultipleO 

Indicates whether the index allows multiple values to be selected. 



Methods inherited from interface com.conceptis.cms.ObiectWithPrimarvKev 

get Primary Key 



Method Detail 



1.1.21.1 getName 

public java . lang. String getName ( ) 

throws Connect ionExcept ion , 

Author i zat ionExcept ion 

Provides the name of the index. 
Returns: 

the name of the index 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 
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ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



5 1.1.21.2 getValidValues 

public java .util . Set getValidValues ( ) 

throws Connect ionExcept ion , 

Author izationExcept ion 
Provides the valid values of this index. 
1 0 Returns: 

the valid values of this index (a set containing Strings) 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

1 5 conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.21.3 getDefaiiltValue 
20 public java . lang. String getDef aultValue ( ) 

throws Conne c t ionExc ep t i on , 

Authorizat ionExcept ion 

Provides the default value of this index. 
Returns: 

25 the default value of this index 

Throws: 

Author izationExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
30 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 



1.1.21.4 isMultiple 
public boolean IsMultiple () 
35 throws ConnectionException , 

Authorizat ionExcept ion 
Indicates whether the index allows multiple values to be selected. 
Returns: 

true if multiple values are allowed, false otherwise 
40 Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
45 performance reason). 
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1 . 1 .22 Interface IndexFactory 



public interface IndexFactory 

Interacts with the CMS to provide access indices of the CMS. 



Method Summary 


Index 


getlndex (com. concept is .util . PrimarvKey key) 
Provides the index for the specified key. 


java.util.Set 


getlndices (Item item) 

Provides the indices available for a branch. 



Method Detail 

i. ■ : ■ ■■■ - ^ ■■■■ , ■ '"^ ' 




1.1.22.1 getlndex 

public Index getlndex (com. concept is .util . PrimaryKey key) 
throws ConnectionBxception # 

AuthorizationException , 
MissingResourceException 
Provides the index for the specified key. 
Parameters: 

key - the primary key of the index 
Returns: 

the index with the primary key 
Throws: 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

Mi s singResourceExcept ion - if the user specified by the key does not exist 



1.1.22.2 getlndices 

public java.util.Set getlndices (Item item) 

throws ConnectionException , 

AuthorizationException , 
Miss ingRe sour ceExcep t ion 
Provides the indices available for a branch. 
Parameters: 

item - the branch to find the indices for 
Returns: 

the indices available for a branch (a set of Index objects); may be empty but not null 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 
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MissingResourceException - if the user specified by the key does not exist 

1.1.23 Interface Item 
All Superinterfaces: 

5 Obi ectWithPrimarvKe v 

public interface Item 

extends ObiectWithPrimarvKev 

An item is the most basic piece of data found in the Content Management System (CMS). 
10 — — — — — — _ 



Method Summary 



boolean 


addlndexvalue (Index index, i ava . lanq. String valnp) 

Adds an index value. 


void 


addRelatedItem(RelationType relationTvDe , 
Item relatedltem, java . util . Map parameters) 

Links an item to this one, using the given Relation Type 
to define the link itself. 


void 


addSupportedLocale (java . util . Locale locale) 

Mark the specified Locale as supported for this item. 


void 


addThesaurusTerm ( int level, iava lana St-riner t-ia-rml 

Indexes the item in a thesaurus. 


BinaryContent 


getBinaryContent ( ) 




Provides the binary content stored in the item. 


Collection 


getCollection ( ) 

Returns the collection to which this item belongs. 


j ava . lang. String 


getComment () 

Returns the comment associated with this item. 


j ava . util . Locale 


getDef aultLocale { ) 

Provides the item's default Locale. 


j ava . lang . Ob j ec t 


getFieldValue (Field field) j 
Returns the value of the Field. 


j ava . lang . Ob j ect 


getFieldValue ( i ava . lancr . Str ina name ) 

Returns the value of the Field identified by the given 

name. 


java .util . Set 


get IndexValues (Index index) 

Provides the index values set on the item. 


java .util . Set 


getlndices () 

Provides the indices available for this item. 


ItemType 


getltemType ( ) 

Returns the <CODEITEMTYPE< code>of this item. 


java. util. Date 


getLastModif iedDate ( ) 

Provides the last modified date. 
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j ava . lang . String 


getLocalizedValue (lava .util . Locale locale) 
Returns the value for the specified Locale. 


j ava . lang . String 


getName ( ) 

Returns the name of this item. 


PublicationStatus 


gotPublicationStatus () 




Returns the PublicationStatus of this item. 


java .util . Set 


getRelatedltems (ItemType itemType) 

Returns a set of items related to this item and that all 
share the same itemType. 


java .util . Set 


getRelatedltems (RelationType relationType) 


Returns a set of items related to this item by the given 
RelationType. 


java. util. Set 


getRelatedltems (RelationType relationType, 


ItemType itemType) 

Returns a Set of items related to this item by the given 
RelationType and that all share the same ItemType. 


java .util . Set 


getRelationType (Item relatedltem) 

Returns the set of ReiationTypes that exist between this 
item and the specified item. 


java .util . Set 


getRelationTypes () 

Provides the ReiationTypes that this object is 
participating in. 


j ava . lang . String 


getShortName () 

Returns the short name associated with this item. 


java .util .Date 


getSignOf fDate () 

Returns the Dateltem to which this PublicationStatus 
was assigned can be signed off automatically. 


java .util .List 


getSupportedLocales () 

Provides the Locales supported for this item. 


com. conceptis .util .Tree 


getThesaurusTerms () 

Get the thesaurus terms associated to the item. 


java. util .List 


getVersions () 

Returns the List of versions associated to this item. 


boolean 


isLocked ( ) 

Returns true if this item is locked for editing; false 
otherwise. 


void 


reject () 

Rejects the item to the previous publication status. 


void 


reject (i ava. lancr.Strincr messaae) 

Rejects the item to the previous publication status, with a 
message. 


void 


removeAllThesaurus Terms () 

Removes all thesaurus terms from the indexation of the 

item 


boolean removelndexValue (Index index, 
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java . lang. String value) 

Removes and index value. 


void 


removeRelatedItem(RelationType relationType , 


Item relatedltem) 

Removes the link between the given item and this one, 

iiic iiiiK uciiig uciiiicu uy liic given KciaLioniype. 


void 


removeSupportedLocale (java .util . Locale locale) 
Unmark the Locale as being supported for this item. 


void 


removeThesaurusTerm ( j ava . lang . String term) 

Removes a thesaurus term from the indexation of the item 


void 


setBinaryContent i java . lang . String mimeType, 

java. io. InputStream inputStream, byte [] termination) 

Qf»tc tVif* V\i ti a?"\/ r*r\r\tf*Tit cfr\TF*r? in flip Tf-om 
ocio uic CHiiary cuuicih aiuicu in uic xuein. 


void 


setBinaryContent ( j ava . lang . String mimeType , 
java . io . InputStream inputStream, long length) 
Sets the binary content stored in the item. 


void 


setCollection (Collection collection) 

Sets the collection to which this item belongs. 


void 


setComment (java . lang. String comment) 

Sets the comment associated with this item. 


void 


setDefaultLocale (java. util .Locale locale) 
Set the item's default Locale. 


void 


setFieldValue (Field field, java. lang. Object value) 
Sets the value of a Field to the given object. 


void 


setFieldValue ( j ava . lang . String name , 
java. lang. Object value) 

Sets the value of a field, identified by its name, to the 
gi ven uo ]ecc. 


void 


setLocalizedValue (java .util .Locale locale, 
java. lang. String value) 

Set the localized value for the specified Locale. 


void 


setName (java . lang . String name) 
Sets the name of this item. 


void 


setShortName ( j ava . lang . String shortName) 

Sets the short name associated with this item. 


void 


setSianOf fDate ( i ava util. Date date) 

Sets the Dateltem to which this Publicationstatus was 
assigned can be signed off automatically. 


void 


signof f ( ) 

Signs off the item to the next publication status. 


void 


signof f (java . lang. String message) 

Signs off the item to the next publication status, with a 
message. 
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Methods inherited from interface com.conceptis.cm s. ObiectWithPrimarvKev 

ge t Pr imary Key — — — 



Method Detail 



1.1.23.1 getltemType 

public ItemType getltemType ( ) 

thirows Author i zationExcept Ion , 
ConnectionException , 
MissingResourceException 
Returns the <CODEITEMTYPE< code>of this Item. 
Returns: 

the ItemType of this item 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - if the type does not exist 



1.1.23.2 setName 

public void setName (java . lang. String name) 
throws AuthorizationException , 
ConnectionException , 
java . lang . IllegalStateException 
Sets the name of this item. 
Parameters: 

name - the name of this item 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang. IllegalStateException - if this item was not locked for editing when 
retrieved. 



1.1.23.3 getName 

public java . lang. String getName ( ) 

throws AuthorizationException , 
ConnectionException 

Returns the name of this item. 
Returns: 

the name of this item 
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Throws: 

Author i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 .1 .23.4 setShortName 

public void setShortName (java . lang . String short Name) 
throws Author i zat ionExcept ion , 

java . lang . IllegalStateException 
Sets the short name associated with this item. 
Parameters: 

shortName - the short name associated with this item 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. IllegalStateException - if this Item was not locked for editing when 
retrieved. 



1 .1 .23.5 getShortName 

public java. lang. String getShortName ( ) 

throws Authorizat ionExcept ion , 
Connect ionExcept ion 
Returns the short name associated with this item. 
Returns: 

the short name associated with this item 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.23.6 setCollection 

public void setCollection ( Collection collection) 

throws Author i zat ionExcept ion , 
Connec t i onExcep t i on , 
java . lang. IllegalStateException 
Sets the collection to which this item belongs. 
Parameters: 

collection - the Collection to which this Item belongs 
Throws: 
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Author i z a t i onExc ep t i on - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang . UlegalStateException - if this Item was not locked for editing when 
retrieved. 



1.1.23.7 getCollection 

public Collection getCollection ( ) 

throws Author Izat ionExcepfcion , 
ConnectionException , 
MissingResourceException 
Returns the Collection to which this item belongs. 
Returns: 

the Collection to which this item belongs 
Throws: 

Author i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

Miss ingRe sour ceExcept ion - if the collection does not exist 



1.1.23.8 setComment 

public void setComment (java . lang. String comment) 
throws AuthorizationException , 
Connect ionExcept ion , 
java . lang . UlegalStateException 
Sets the comment associated with this item. 
Parameters: 

comment - the comment associated with this item 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

Connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. UlegalStateException - if this item was not locked for editing when 
retrieved. 



1.1.23.9 getComment 

public java . lang . String getComment { ) 

throws AuthorizationException , 
Conne c t i onExc ept ion 
Returns the comment associated with this item. 
Returns: 

the comment associated with this item 
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Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

Connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
5 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 



1.1.23.10 setFieldValue 

public void setFieldValue (java . lang. String name, 
10 java . lang. Object value) 

throws Author 1 zat ionExcept ion , 
ConnectionException , 
java . lang. II legal Argument Except ion, 
java . lang. IllegalStateException, 
1 5 MissingResourceException 

Sets the value of a field, identified by its name, to the given object. 
Parameters: 

name - the name of the field 

value - the value of the field, which can be any object 
20 Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
25 performance reason). 

java . lang. UlegalArgumentException - if the value is not acceptable for the 
corresponding Field 

java . lang. IllegalStateException - if this Item was not locked for editing when 
retrieved. 

30 MissingResourceException - if the item type does not exist 



1.1.23.11 getFieldValue 

public java. lang. Object getFieldValue (java . lang . String name) 

throws AuthorizationException , 
35 Connect ionExcept ion , 

java . lang . illegalArgumentException, 
MissingResourceException 

Returns the value of the Field identified by the given name. If the corresponding 

Field does not have a value set, this method will return null. If the specified Field 

40 cannot be found, this method will throw an UlegalArgumentException. 

Parameters: 

name - the name of the Field 
Returns: 

the value of the Field, which can be any object; null if no value has been set 
45 Throws: 

Author i za t ionExcept ion - if the current user does not have permission to perform 
this operation 
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connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. Illegal Argument Except ion - if no Field can be found for the specified 
name 

MissingResourceException - if the item type does not exist 



1.1.23.12 setFieldValue 

public void setFieldValue ( Field field, 

java . lang. Object value) 
throws Author izat ionExcspt ion , 
ConnectionException , 
java . lang. IllegalArgumentExcept ion, 
java . lang. IllegalStateException, 
MissingResourceException 

Sets the value of a Field to the given object. 

Parameters: 

field - the Field 

value - the value of the field, which can be any object 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

j ava . lang . IllegalArgumentExcept ion - if the value is not acceptable for the 
corresponding Field 

java . lang. UlegalstateExcept ion - if this item was not locked for editing when 
retrieved. 

MissingResourceException - if the item type does not exist 



1.1.23.13 getFieldValue 

public java. lang. Object getFieldValue ( Field field) 

throws AuthorizationException , 
ConnectionException , 
java . lang. Illegal Argument Except ion, 
Mi s s ingResourceExcept ion 

Returns the value of the Field. If the corresponding Field does not have a value set, 

this method will return null. If the specified Field cannot be found, this method will 

throw an IllegalArgumentException. 

Parameters: 

field - the Field 

Returns: 

the value of the Field, which can be any object; null if no value has been set 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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conne c t i onBxc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang . UlegalArgumentException - if no Field can be found for the specified 
5 name 

Miss ingRe sourceExcep t ion - if the item type does not exist 

1.1.23.14 getPublicationStatus 

public PublicationStatus getPublicationStatus ( ) 

10 throws AuthorizationException , 

ConnectionSxccption , 
MissingResourceException 

Returns the PublicationStatus of this item. 
Returns: 

15 the PublicationStatus of this Item 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
20 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 

MissingResourceException - if the status does not exist 

1.1.23.15 getVersions 

25 public java .util . List getVersions ( ) 

throws Author i zat ionExcept ion , 
Connect ionExcept ion 

Returns the List of versions associated to this item. 

Returns: 

30 the List of versions associated to this item 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
35 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 

1.1.23.16 getBinaryContent 

public BinaryContent getBinaryContent ( ) 
40 throws AuthorizationException , 

Mi s s ingResour ceExcept ion , 
Connect ionExcept ion 

Provides the binary content stored in the item. If there is no binary content in this item, 
it will return null. 
45 Returns: 

the binary content in the item, null if there is no binary content 
Throws: 
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AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the item does not exist 

connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.23.17 setBinaryContent 

public void setBinaryContent (j ava . lang . String mimeType, 

java.io. Inputs tream inputs tream, 

long Icliy th) 

throws AuthorizationException , 

ConnectionException , 

MissingResourceException , 

j ava . io . IOExcept ion , 

j ava . lang . IllegalStateException 
Sets the binary content stored in the item. The binary content can be set to null. Note: 
unlike most set methods, the implementation of this method will immediatly send the 
data to the repository. Therefore, the Item must be locked for editing before a call to 
this method is made. After the method returns, the lock on the item is released and 
must be obtained again. 
Parameters: 

mimeType - the MIME type of this binary content 

inputstream - the inputstream that contains the data of the item 

length - the length of the content 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . io . IOExcept ion - if an error occurs while accessing the inputstream 

java . lang. IllegalStateException - if this item was not locked for editing when 

retrieved. 

MissingResourceException - if the item does not exist 



1.1.23.18 setBinaryContent 

public void setBinaryContent (java . lang . String mimeType, 

java . io. Inputstream inputstream, 
byte [] termination) 
throws AuthorizationException , 
ConnectionException , 
MissingResourceException , 
java . io . IOExcept ion, 
java . lang . IllegalStateException 

Sets the binary content stored in the item. The binary content can be set to null. 

Authorization required: Action.UPDATE on the item Note: unlike most set methods, 

the implementation of this method will immediatly send the data to the repository. 

Therefore, the Item must be locked for editing before a call to this method is made. 

After the method returns, the lock on the item is released. 
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Parameters: 

mimeType - the MIME type of this binary content 

inputstream - the inputstream that contains the data of the item 

termination - the termination pattern 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . io . iOException - if an error occurs while accessing the inputstream 

java . lang . UlegalStateException - if this item was not locked for editing when 

retrieved. 

MissingResourceException - if the item does not exist 



1.1.23.19 signoff 

public void signoff () 

throws AuthorizationException , 
Connect ionException , 
java . lang. UlegalStateException, 
MissingResourceException 
Signs off the item to the next publication status. 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. UlegalStateException - if this Item is in it's final publication status 
MissingResourceException - if the status does not exist 



1.1.23.20 signoff 

public void signoff (java . lang. String message) 
throws AuthorizationException , 
ConnectionExcept ion , 
j a va . 1 ang .111 ega 1 S t a t eExc ep t i on , 
MissingResourceException 
Signs off the item to the next publication status, with a message. 
Parameters: 

message - a note to associate with the signing off 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang . UlegalStateException - if this item is in it's final publication status 
MissingResourceException - if the status does not exist 
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1.1.23.21 reject 

public void reject () 

throws AuthorizationException , 
Connect ionExcept ion , 
java . lang . UlegalStateException, 
MissingResourceException 
Rejects the item to the previous publication status. 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. UlegalStateException - if this Item is in it's final publication status 
Miss ingRe sour ceExcep t i on - if the status does not exist 



1.1.23.22 reject 

public void reject (java . lang . String message) 
throws AuthorizationException , 
ConnectionException , 
java. lang. UlegalStateException, 
Mi s s ingRe sourceExcept ion 

Rejects the item to the previous publication status, with a message. 
Parameters: 

message - a note to associate with the signing off 
Throws: 

Author i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. UlegalStateException - if this Item is in it's final publication status 
MissingResourceException - if the status does not exist 



1.1.23.23 addRelatedltem 

public void addRe la t ed 1 1 em ( Re 1 a t i onTyp e relationType, 

Item relatedltem, 

java. util .Map parameters) 
throws AuthorizationException , 

Connect ionExcept ion , 

java. lang. UlegalStateException 
Links an item to this one, using the given RelationType to define the link itself. The 
relation type works like this: if you want to add a parent item to this item, you would 
call the following: this. addRelatedltem (RelationType. PARENT, parentltem) /. 
Parameters: 

relationType - the RelationType that characterizes the link between this item and 
the other. 

relatedltem - the Item to link to this Item 
parameters - any parameters to apply to the relationship 
Throws: 
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AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
5 performance reason). 

java. lang. niegalstateException - if the specified RelationType already defines 
a unique linked item; or if trying to save an item that was not locked for editing when 
retrieved. 



10 1.1.23.24 getRelatedltems 

public java. util. Set getRelatedltems ( RelationType relationType) 

throws AuthorizationException , 
Connect ionExcept ion 
Returns a Set of items related to this item by the given RelationType. The Set may 
15 be empty, but never null. 

Parameters: 

relationType - the RelationType that characterizes the link between this item and 

the others. 

Returns: 

20 set of items related to this one by the given RelationType 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
25 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 



1.1.23.25 getRelatedltems 

public java. util .Set getRelatedltems ( itemType itemType) 
30 throws Author i zat ionExcept ion , 

Connect ionExcept ion 
Returns a Set of items related to this item and that all share the same itemType. The 
set may be empty, but never null. 
Parameters: 

35 itemType - the itemType shared by all the related items in the returned set. 

Returns: 

Set of items related to this one and that al share the given itemType 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
40 this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



45 1.1.23.26 getRelatedltems 

public java. util. Set getRelatedltems ( RelationType relationType, 

ItemType itemType) 
throws AuthorizationException , 
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Connec t ionExcept ion 
Returns a Set of items related to this item by the given ReiationType and that all 
share the same itemType. The set maybe empty, but never null. 
Parameters: 

5 reiationType - the ReiationType that characterizes the link between this item and 

the others. 

itemType - the itemType shared by all the related items in the returned Set. 
Returns: 

set of items related to this one and that al share the given itemType 
10 Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
15 performance reason). 

1.1.23.27 getRelationType 

public java .util . Set getRelationType ( Item relatedltem) 

throws AuthorizationException , 
20 Connect ionExcept ion 

Returns the set of RelationTypes that exist between this item and the specified item. 
The returned set may be empty (no relation between the two), but never null. 
Parameters: 

relatedltem - the item that may be related to this one by one or more RelationTypes 
25 Returns: 

set of ReiationType defined between this item and the specified item 
Throws: 

Authori za tionExcept ion - if the current user does not have permission to perform 
this operation 

30 conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 .1 .23.28 removeReiatedltem 
35 public void removeReiatedltem ( ReiationType reiationType, 

Item relatedltem) 
throws AuthorizationException , 
Connec t ionExcept i on , 
java . lang. IllegalStateException 

40 Removes the link between the given item and this one, the link being defined by the 

given ReiationType. The relation type works like this: if you want to remove a child 
item from this item, you would call the following: 
this . removeReiatedltem (ReiationType . CHILD, childltem) ;. 
Parameters: 

45 reiationType - the ReiationType that characterizes the link between this item and 

the other. 

relatedltem - the Item to unlink from this Item 
Throws: 
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AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. UlegalstateException - if this item was not locked for editing when 
retrieved. 



1.1.23.29 getRelationTypes 

public java. util. Set getRelationTypes ( ) 

throws AuthorizationException , 
Conne c t i onE xc ep t i on , 
java. lang. UlegalstateException 
Provides the RelationTypes that this object is participating in. 
Returns: 

a set of relation types that this item is in 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java. lang. UlegalstateException - if this Item was not locked for editing when 
retrieved. 



1.1.23.30 isLocked 

public boolean isLocked () 

throws AuthorizationException , 
ConnectionException 
Returns true if this item is locked for editing; false otherwise. 
Returns: 

true if this item is locked for editing; false otherwise. 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onEx c ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.23.31 getSignOffDate 

public java. util. Date getSignOf f Date ( ) 

throws AuthorizationException , 
ConnectionException 
Returns the Dateltem to which this Pubiicationstatus was assigned can be signed 
off automatically. This only applies to a Pubiicationstatus that has been set to 

# S I GN_0 F F_AUT OMAT I C AL L Y_AT . 

Returns: 
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the Date to reach before the item to which this Pubiicationstatus was assigned can 

be signed off automatically 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

Connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.23.32 setSignOffDate 

public void setsignof fDate ( java . util .Date date) 

throws AuthorizationException , 
Connect ionExcept ion 

Sets the Dateltem to which this pubiicationstatus was assigned can be signed off 
automatically. This only applies to a Pubiicationstatus that has been set to 

# S I GN_OF F_AUTOMAT I C ALL Y_AT . 

Parameters: 

date - the Date to reach before the Item to which this Pubiicationstatus was 

assigned can be signed off automatically 

Throws: 

Author iza t ionExcept ion - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 . 1 .23.33 addThesaurusTerm 

public void addThesaurusTerm (int level, 

java . lang. String term) 
throws AuthorizationException , 
Connect ionExcept ion 
Indexes the item in a thesaurus. 
Parameters: 

level - the level, 1 for primary term, 2 for secondary term, etc. 

term - the term The thesaurus term to index the item with. Must be part of the 

thesaurus 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

c onne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 .1 .23.34 removeThesaurusTerm 

public void removeThesaurusTerm ( java . lang . String term) 

throws AuthorizationException , 
Connect ionExcept ion 
Removes a thesaurus term from the indexation of the item 
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Parameters: 

term - the term The thesaurus term to index the item with. Must be part of the 

thesaurus 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 . 1 .23.35 removeAIIThesaurusTerms 

public void removeAIIThesaurusTerms ( ) 

throws AuthorizationException , 
Connect ionExcept ion 
Removes all thesaurus terms from the indexation of the item 
Throws: 

Author i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

Conne c t i on Exc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.23.36 getThesaurusTerms 

public com. conceptis .util . Tree getThesaurusTerms ( ) 

throws AuthorizationException , 
Connect ionExcept ion 
Get the thesaurus terms associated to the item. Item at the first level are primary terms, 
at the second level are secondary term and so on. 
Returns: 

com.conceptis.util.Tree the tree of thesaurus term associated with the item 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.23.37 setDefaultLocale 

public void setDefaultLocale (java . util . Locale locale) 

throws Connect ionExcept ion , 

AuthorizationException 
Set the item's default Locale. An item cannot be saved unless the localized value for 
the default Locale is completed. (Other supported Locales pose no such restrictions) 
This information is persisted in the item using XML. 
Parameters: 

locale - The Locale that this object *must* support in order to be persisted in the 

CMS. May be null (in which case no locale is required). 

Throws: 
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connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 



1.1.23.38 getDefaultLocale 

public java .util . Locale getDef aultLocale () 

throws ConnectionException , 

AuthorizationException 

Provides the item's default Locale. An item cannot be saved unless the localized value 

for the default Locale is completed. (Other supported Locales pose no such 

restrictions) This information is persisted in the item using . 

Returns: 

the default locale 

Throws: 

connect ionException - if there is a problem interacting with the CMS 

Author i zat ionExcept ion - if the current user does not have permission to perform 

this operation 



1 .1 .23.39 getLocalizedValue 

public java . lang. String getLocalizedValue (java . util . Locale locale) 

throws Connect ionException , 

AuthorizationException , 

j ava . lang . IllegalArgumentException 

Returns the value for the specified Locale. If is not part of the item's supported 

Locales, an IllegalArgumentException is thrown. 

Parameters: 

locale - The Locale for the accompanying value. 
Returns: 

The string of the localized value. 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

java . lang. IllegalArgumentException - if the specified Locale is not supported by 
this item. 



1.1.23.40 setLocalizedValue 

public void setLocalizedValue (java . util . Locale locale, 

java . lang. String value) 
throws ConnectionException , 

AuthorizationException , 

java . lang. IllegalArgumentException 

Set the localized value for the specified Locale. 
Parameters: 

locale - The Locale for the accompanying value, 
value - The string of the localized value. 
Throws: 

ConnectionException - if there is a problem interacting with the CMS 
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AuthorizationException - if the current user does not have permission to perform 
this operation 

j ava . lang . II legal Argument Except ion - if the specified Locale is not supported by 
this item. 



1.1.23.41 addSupportedLocale 

public void addSupportedLocale (j ava . util . Locale locale) 

throws Connect ionExcept ion , 

AuthorizationException , 
j ava. lang. IllegalStateException 
Mark the specified Locale as supported for this item. (This information is stored in the 
xmlLocaleString field). Having no values for these locales will *not* prevent the item 
from being saved to the CMS, however business logic *IS* expected to prevent the 
items from having their publishing states set anything that may be viewable! ! ! 
Parameters: 

locale - The Locale to support. 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

j ava. lang. IllegalStateException - if the specified Locale is already listed as 
being supported, (either as a default *or* supported locale) 



1 . 1 .23.42 removeSupportedLocale 

public void removeSupportedLocale (j ava .util . Locale locale) 

throws Connect ionExcept ion , 

AuthorizationException , 
java . lang . IllegalStateException 
Unmark the Locale as being supported for this item. (This information is stored in the 
xmlLocaleString field). Localized values already set will not be deleted, however, they 
will no longer be visible/editable unless the Locale is once again marked as being 
supported. 
Parameters: 

locale - The Locale to no longer support. 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

java. lang. IllegalStateException - if the specified Locale is not listed as being 
supported, (either as a default *or* supported locale) 



1.1.23.43 getSupportedLocales 

public java. util. List getSupportedLocales ( ) 

throws Connect ionException , 

AuthorizationException , 
java. lang. IllegalStateException 
Provides the Locales supported for this item. (This information is stored in the 
xmlLocaleString field). 
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Returns: 

a list of Locale objects 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
5 Author i zat ionExcept ion - if the current user does not have permission to perform 

this operation 

java . lang. IllegalStateException - if the specified Locale is not listed as being 
supported, (either as a default *or* supported locale) 



10 1.1 .23.44 getLastModifiedDate 

public java .utii .Date getLastModif iedDate ( ) 

throws Connect ionExcept ion , 

Authori zat ionExcept ion 

Provides the last modified date. 
1 5 Returns: 

the date the item was last modified. 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
Authori zat ionExcept ion - if the current user does not have permission to perform 
20 this operation 



1.1.23.45 getlndexValues 

public java .util . Set getlndexValues ( Index index) 

throws AuthorizationException , 
Connect ionExcept ion 
Provides the index values set on the item. 
Parameters: 
index - the index 
Returns: 

the values on the index 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 

Authori zat ionExcept ion - if the current user does not have permission to perform 

this operation 



1.1.23.46 addlndexValue 

public boolean addlndexValue ( Index index, 

java . lang . String value) 
throws AuthorizationException / 
40 Connect ionExcept ion 

Adds an index value. 
Parameters: 
index - the index 
value - the value of the index 
45 Returns: 

true if the set of index values changed as a result of this operation 
Throws: 

Connect ionExcept ion - if there is a problem interacting with the CMS 



25 



30 
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Authoriz ationException - if the current user does not have permission to perform 
this operation 



1.1.23.47 removelndexValue 
5 public boolean removelndexValue ( Index index, 

java.lang. String value) 
throws AuthorizationException , 
Conn e c t i onExc ep t i on 

Removes and index value. 
0 Parameters: 

index - the index 

value - the value of the index 

Returns: 

true if the set of index values changed as a result of this operation 
5 Throws: 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 



1.1.23.48 getlndices 

public java.util.Set getlndices () 

throws ConnectionException , 

AuthorizationException , 
MissingResourceException 
Provides the indices available for this item. 
Returns: 

the indices available for a branch (a set of Index objects); may be empty but not null 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the user specified by the key does not exist 
1 .1 .24 Interface ItemFactory 



public interface ItemFactory 

Interacts with the CMS to provide access to items of the CMS. 



! ~ 

Method Summary 


void 


addRootltemdtem root) 

Sets the root item of the site. 


Item 


createNewItem (itemType itemTvce) 

Creates a new item instance, uninitialized, not 
stored in the CMS. 
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VUIU 


HaI af aTf am / Tf-am -i +- A m\ 

aexeteiteiD u ceiu lLeinj 

Deletes this item. 


Item 


get Item (com. conceptis . util . PrimarvKey key. 
uuoicaii locKr or ciaiLing ) 

Provides the item with the specified key. 


I t em 


9 otitein i j avd . ±a.ncj . o tr incj laencit ler . 
boolean lockForEditing) 

Provides the item with the specified identifier. 


Item 


getltem( java.net .URL identifier, 
boolean lockForEditing) 

Provides the item with the specified URL. 


java.util.Set 


getltems () 

Provides the set of all items. 


java .util . Set 


getltems (ItemType itemType) 

Returns a set of item that all share the same 
ItemType. 


java .util . Set 


getltems (ItemType itemType, Item top) 

Returns a set of item that all share the same 
itemType and are under the same item. 


java. util . Set 


getRootltems ( ) 

Provides the root items of the site. 


void 

... . ..... „ :! 


lockltemdtem item) 

Unlocks the specified item without saving any 
changes, therefore making it available for editing to 
someone else. 


void 


removeRootltemdtem root) 

Sets the root item of the site. 


void 


saveltemdtem item) 

Saves the specified item. 


com. conceptis .util . PagedList 


search (ItemSearchConstraints constraints) 


Searches for items matching the constraints. 


java .util . Set 


searchForltem ( ItemSearchConsfra i n t q rnn « t- -j -n \- a \ 


Deprecated, wse 

search (com . conceptis . cms . I temSearchConstraints ) T 


which returns a paged list 


void 


unlockltemdtem item) 

Unlocks the specified item without saving any 
changes, therefore making it available for editing to 
someone else. 




Method Detail 



1.1.24.1 getltems 

public java.util.Set getltemsO 



95 



throws Connec t ionExc ep t ion , 

AuthorizationException 

Provides the set of all items. 
Returns: 

the set of all items (may be empty but never null) 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 



1.1.24.2 getltem 

public Item getltem (com. concept is . util . PrimaryKey key, 

boolean lockForEditing) 
throws Connec t ionExcept ion , 

AuthorizationException , 
java. lang. UlegalStateException, 
MissingResourceException 
Provides the item with the specified key. 
Parameters: 

key - the primary key of the item 

lockForEditing - set to true to retrieve this item in edition mode, allowing the 
changes made to it to be saved; set to false to get this item in a read-only mode. 
Returns: 

the item with the specified key 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

java . lang. UlegalstateException - if the item is already locked for editing by 
another party 

MissingResourceException - if the item specified by the key does not exist 



1.1.24.3 getltems 

public java. util. Set getltems ( ItemType itemType, 

Item top) 
throws ConnectionException , 

AuthorizationException 
Returns a set of item that all share the same itemType and are under the same item. 
Parameters: 

itemType - the itemType shared by all returned items 
top - the item that represents the branch to search under. 
Returns: 

a set of item that all share the same itemType. 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 
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1.1.24.4 getltem 

public Item getltem (java . lang. String identifier, 

boolean lockForEditing) 
throws ConnectionException , 

AuthorizationException , 
java . lang. IllegalstateException, 
MissingResourceException 
Provides the item with the specified identifier. 
Parameters: 

identifier - a string that uniquely identifies the desired resource 
lockForEditing - set to true to retrieve this item in edition mode, allowing the 
changes made to it to be saved; set to false to get this item in a read-only mode. 
Returns: 

the item with the specified identifier 
Throws: 

conne c t i onEx c ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

java . lang . IllegalstateException - if the Item is already locked for editing by 
another party 

MissingResourceException - if the item specified by the key does not exist 



1.1.24.5 getltem 

public Item getltem (java . net . URL identifier, 

boolean lockForEditing) 
throws ConnectionException , 

AuthorizationException , 
java . lang. IllegalstateException, 
MissingResourceException 
Provides the item with the specified URL. 
Parameters: 

identifier - a string that uniquely identifies the desired resource 
lockForEditing - set to true to retrieve this item in edition mode, allowing the 
changes made to it to be saved; set to false to get this item in a read-only mode. 
Returns: 

the item with the specified identifier 
Throws: 

ConnectionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

j ava . lang .IllegalstateException - if the item is already locked for editing by 
another party 

MissingResourceException - if the Item specified by the key does not exist 



1.1.24.6 getRootl terns 

public java .util . Set getRoot Items ( ) 

throws Conn e c t i onExc ep t i on , 

AuthorizationException , 
Mi ss ingRe sourceExcept ion 

Provides the root items of the site. 
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Returns: 

the root items of the site 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the Items do not exist 



1.1.24.7 addRootltem 

public void addRootltem ( Item root) 

throws ConnectionException , 

AuthorizationException , 
MissingResourceException 
Sets the root item of the site. 
Parameters: 

root - the root item of the site 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
Authoriz ationException - if the current user does not have permission to perform 
this operation 

MissingR esourceException - if the item specified by the key does not exist 



1 .1 .24.8 removeRootltem 

public void removeRootltem ( Item root) 

throws Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Sets the root item of the site. 
Parameters: 

root - the root item of the site 
Throws: 

conne c t ionExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the item specified by the key does not exist 



1.1.24.9 getltems 

public java.util.Set getltems ( ItemType itemType) 

throws Conne c t i onExc ep t i on , 

AuthorizationException 
Returns a set of item that all share the same itemType. 
Parameters: 

itemType - the itemType shared by all returned items 
Returns: 

a set of item that all share the same itemType. 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
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AuthorizationException - if the current user does not have permission to perform 
this operation 



1.1.24.10 createNewltem 
5 public Item createNewltem ( ItemType itemType) 

Creates a new item instance, uninitialized, not stored in the CMS. Once correctly 
initialized, this instance may then be inserted in the CMS using the 
saveItem(com. conceptis . cms . Item) method. 
Parameters: 

1 0 itemType - the ItemType of the newly created Item 

Returns: 

an unitialized item of the specified itemType 



1.1.24.11 saveltem 

public void saveltem ( Item item) 

throws Connect ionExcept ion , 

Author izationExcept ion , 

MissingResourceException , 

j ava . lang . IllegalStateException 
Saves the specified item. This will change the item's entry in the CMS to reflect the 
state of the item parameter. If the given item did not exist before, it will be inserted, 
otherwise it will simply be updated. If the item was locked for editing, it will be 
unlocked. 
Parameters: 

item - the item to insert/update 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing item does not exist any longer 
java . lang . IllegalStateException - if trying to save an item that was not locked 
for editing when retrieved. 



1.1.24.12 unlockltem 
35 public void unlockltem ( Item item) 

throws ConnectionException , 

AuthorizationException , 
MissingResourceException 

Unlocks the specified item without saving any changes, therefore making it available 
40 for editing to someone else. If the item was not locked, this method will simply do 

nothing. 
Parameters: 
item - the Item to unlock 
Throws: 

45 ConnectionException - if there is a problem interacting with the CMS 

AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing item does not exist any longer 



15 
20 

25 

30 
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1.1.24.13 lockltem 

public void lockltem (Item item) 

throws Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Unlocks the specified item without saving any changes, therefore making it available 
for editing to someone else. If the item was not locked, this method will simply do 
nothing. Authorization required: none 
Parameters: 
item - the Item to unlock 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing item does not exist any longer 



1.1.24.14 deleteltem 

public void deleteltem ( Item item) 

throws ConnectionException , 

AuthorizationException , 

MissingResourceException 
Deletes this item. This may have unintended consequences. Note that some 
implementations may throw an UnsupportedOperationException if the deletion of 
items is not possible. 
Parameters: 
item - the item to delete 
Throws: 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the item does not exist any longer 



1.1.24.15 searchForltem 

public java.util.Set searchForltem ( ItemSearchCons traints constraints) 

throws ConnectionException , 

Authori zat ionExcept ion 
Deprecated, use search ( com , conceptis . cms . ItemSearchCons traints ) , which 
returns a paged list 

Searches for items matching the constraints. 
Parameters: 

constraints - the constraints of the search 
Returns: 

a set of items matching the constraints 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 
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1.1.24.16 search 

public com. concept is .util . PagedList search ( ItemSearchConstraints constraints) 

throws Connect ionExcept ion , 
5 Author izationExcept ion , 

MissingResourceException 

Searches for items matching the constraints. 
Parameters: 

constraints - the constraints of the search 
1 0 Returns: 

a set of items matching the constraints 
Throws: 

connectionException - if there is a problem interacting with the CMS 
AutnorizationException - if the current user does not have permission to perform 
1 5 this operation 

MissingResourceException - if the search could not be performed 

1 . 1 .25 Interface ItemType 

All Superinterfaces: 

20 Obi ectWithPrimarvKey 



public interface ItemType 
extends ObiectWithPrimarvKev 

An ItemType defines a family of item s that all share the same constraints, Field s, 
25 PublishingFlow , etc.. 



Method Summary 


void 


addField (Field field) 

Adds a Field in this ItemType. 


void 


addField (int index, Field field) 
Adds a Field in this ItemType. 


void 


addRelatedltemType (RelationType relationType, 


ItemType itemType) 

Links an itemType to this one, using the given RelationType to 
define the link itself. 


java . util . Set 


getChildren () 

Provides the children types of this type. 


Collection 


getCollection ( ) 

Provides the collection that this itemType belongs to. 


Field 


getField(int index) 

Returns the Field identified by the provided index. 


Field 


getField (java . lang. String name) 

Returns the Field identified by the given name. 


java .util .List 


getFieldsO 
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Returns a List of Fields defined in this ItemType. 


java.util .Set 


getltems () 

Returns all the items that share this ItemType. 


xnt 


getMaximumVersions () 

Provides the number of versions that should be maintained for this 

I t emTvD e 


j ava . lang . String 


getName ( ) 

Returns the name of this ItemType. 


ItemType 


getParent () 

Provides the parent type of this type. 


PublishingFlow 


getPublishingFlow ( ) 




Returns the PublishingFlow assigned to this ItemType. 


java.util . Set 


getRelatedltemTypes (RelationType relationType) 


Returns a Set of itemTypes related to this ItemType by the given 

RelationTvoe 


boolean 


isBinaryO 

Indicates whether this resource type contains binary content. 


void 


removeField (int index) 

Removes the Field at the specified index. 


void 


removeField ( j ava . lang . String name ) 

Removes the Field at the specified index. 


void 


removeRelatedltemType (RelationType relationType, Item item) 


Removes the link between the given ItemType and this one, the 
link beinff defined bv the driven ReiationTvoe 


void 


setCollection (Collection collection) 

Sets the collection that this type is defined in. 


void 


setName (j ava. lang. String name) 
Sets the name of this ItemType. 


void 


setPublishingFlow (PublishingFlow publishingFlow) 


Sets the PublishingFlow of this ItemType. 


boolean 


supportsExtendedRelationships () 


Indicates whether this type supports extended relationships. 


boolean 


supportsLocalizedString () 

Indicates whether this type supports a localized string. 



I Methods inherited from interface com.conceptisxms.ObiectWithPrimaryKev 

I get Pr imaryKey 



Method Detail 



102 



1.1.25.1 setName 

public void setName (java . lang. String name) 
throws Author i zat ionExcept ion , 
Connect ionExcept ion 
5 Sets the name of this itemType. 

Parameters: 

name - the name of this ItemType 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
1 0 this operation 

Connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



15 1.1.25.2 getName 

public java . lang. String getName () 

throws AuthorizationException , 
Connect ionExcept ion 

Returns the name of this itemType. 
20 Returns: 

the name of this itemType 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

25 conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.3 addField 
30 public void addField ( Field field) 

throws AuthorizationException , 
Connect ionExcept ion 

Adds a Field in this itemType. The field is placed at the end of the list. 
Parameters: 
35 field - the Field to set 

Throws: 

Authori zat ionExcept ion - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
40 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 



1.1.25.4 addField 

public void addField (int index, 
45 Field field) 

throws AuthorizationException , 
Connect ionExcept ion , 
java. lang. IndexOutOf BoundsException 
Adds a Field in this ItemType. The index can be specified. 
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Parameters: 

index - the index of the Field 
field - the Field to set 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i on Exc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

j ava . lang . indexOutOf BoundsExcept ion - if the index is negative or larger then the 
current field count 



1.1.25.5 getField 

public Field getField (j ava . lang. String name) 
throws AuthorizationException , 
ConnectionException 

Returns the Field identified by the given name. 

Parameters: 

name - the name of the field 
Returns: 

the Field that fits the specified name, null if it is not a field of this type 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.6 getField 

public Field getField (int index) 

throws AuthorizationException , 
ConnectionException , 
java . lang. IndexOutOf BoundsExcept ion 

Returns the Field identified by the provided index. 
Parameters: 

index - the index of the field 
Returns: 

the Field that fits the specified name 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang. IndexOutOf BoundsExcept ion - if the index is invalid 
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1.1.25.7 removeField 

public void removeField ( java . lang. String name) 
throws AuthorizationException , 
Connect ionExcept ion 
Removes the Field at the specified index. 
Parameters: 

name - the name of the field 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conn e c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.8 removeField 

public void removeField ( int index) 

throws AuthorizationException , 
Connect ionExcept ion , 
java . lang. IndexOutOf BoundsExcept ion 
Removes the Field at the specified index. 
Parameters: 

index - the index of the field 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang . IndexOutOf BoundsExcept ion - if the index is invalid 



1.1.25.9 getFields 

public java. util. List getFields () 

throws AuthorizationException , 
ConnectionException 
Returns a List of Fields defined in this itemType. 
Returns: 

a List of Fields defined in this ItemType, in no particular order 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.10 setPublishingFlow 

public void setPublishingFlow ( PublishingFlow publishingFlow) 

throws AuthorizationException , 
ConnectionException 
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Sets the PublishingFlow of this ItemType. 
Parameters: 

publishingFlow - PublishingFlow to assign to this ItemType 
Throws: 

Au t hor i za t ionBxcep t ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.11 getPublishingFlow 

public PublishingFlow getPublishingFlow ( ) 

throws AuthorizationException , 
Connect ionExcepti on , 
MissingResourceException 
Returns the PublishingFlow assigned to this ItemType. 
Returns: 

the PublishingFlow assigned to this ItemType 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - if the flow does not exist 



1.1.25.12 getCollection 

public Collection getCollection ( ) 

throws AuthorizationException , 
ConnectionException , 
MissingResourceException 
Provides the collection that this ItemType belongs to. It is possible that this value is 
null, since a type is not required to be in a collection. 
Returns: 

the collection the type is in, or null if it is not in a collection 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - if the collection does not exist 



1.1.25.13 setCollection 

public void setCollection ( Collection collection) 

throws AuthorizationException , 
ConnectionException 
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Sets the collection that this type is defined in. It is acceptable to pass null into this 

method, since a type is not required to be in a collection. 

Parameters: 

collection - the collection that the type is in, pass null to remove the type 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.14 getParent 

public ItemType getParent () 

throws AuthorizationException , 
Connect ionExcept ion , 
MissingResourceException 
Provides the parent type of this type. 
Returns: 

the parent type of this type 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne ct ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - if the parent does not exist 



1.1.25.15 getChildren 

public java.util .Set getChildren ( ) 

throws Authori zat ionExcep t ion , 
Connect ionExcept ion , 
MissingResourceException 
Provides the children types of this type. 
Returns: 

the children types of this type 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - if the parent does not exist 



1.1.25.16 getMaximumVersions 
public int getMaximumVersions ( ) 

throws AuthorizationException , 
Conne c t i onExc ep t i on 
Provides the number of versions that should be maintained for this ItemType. 
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Returns: 

the number of versions to maintained for this type 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
5 this operation 

Connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



10 1.1.25.17 isBinary 

public boolean isBinary () 

throws Author i zat ionExcept ion , 
Connect ionExcept ion 

Indicates whether this resource type contains binary content. 
15 Returns: 

true if the Item contains binary content, false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

20 conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.18 getltems 
25 public java .util . Set getltems () 

throws Author i zat ionExcept ion , 
Connect ionExcept ion , 
Mi ss ingResour ceExcept ion 

Returns all the items that share this itemType. 
30 Returns: 

a Set of items that all share this itemType 
Throws: 

Author i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

35 conne c t i onExc ep t i on - if there is a problem interacting with the CMS 

MissingResourceException - if an item is missing 



1.1.25.19 addRelatedltemType 

public void addRelatedltemType ( RelationType relationType, 
40 ItemType itemType) 

throws AuthorizationException ; 
ConnectionException , 
java . lang. IllegalStateException 

Links an ItemType to this one, using the given RelationType to define the link itself. 
45 The relation type works like this: if you want to define an image type for a news type, 

you would call something similar to the following line of code: 
this . addRelatedltemType { "news . image" , imageType) ; . 
Parameters: 
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reiationType - the ReiationType that characterizes the link between this itemType 
and the other. 

itemType - the ItemType to link to this ItemType 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang . UlegalStateException - if the specified ReiationType already defines 
a unique linked itemType 



1.1.25.20 getRelatedltemTypes 

public java .util . Set getRelatedltemTypes ( ReiationType reiationType) 

throws AuthorizationException , 
ConnectionException 

Returns a Set of itemTypes related to this ItemType by the given ReiationType. The 

set may be empty, but never null. 

Parameters: 

reiationType - the ReiationType that characterizes the link between this ItemType 

and the others. 

Returns: 

set of ItemTypes related to this one by the given ReiationType 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 .1 .25.21 removeRelatedltemType 

public void removeRelatedltemType ( ReiationType reiationType, 

Item item) 
throws Author i zat ionExcept ion , 
ConnectionException 

Removes the link between the given ItemType and this one, the link being defined by 
the given ReiationType. The relation type works like this: if you want to remove an 
image ItemType from a news ItemType, you would call something similar to the 
following line of code: this . removeRelatedltemf "news . image" , imageType) ; . 
Parameters: 

reiationType - the ReiationType that characterizes the link between this ItemType 
and the other. 

item - the ItemType to unlink from this ItemType 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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Connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



5 1.1 .25.22 supportsExtendedRelationships 

public boolean supportsExtendedRelationships ( ) 

throws Author izat ionExcept ion , 
Connect ionExcept ion 
Indicates whether this type supports extended relationships. 
1 0 Returns: 

true if the item supports extended relationships, false otherwise 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

1 5 conn ectionException - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.25.23 supportsLocalizedString 
20 public boolean supportsLocalizedString ( ) 

throws Authorizat ionExcept ion , 
Connect ionExcept ion 
Indicates whether this type supports a localized string. 
Returns: 

25 true if the item supports elocalized string, false otherwise 

Throws: 

Aut hor i zat ionExcept ion - if the current user does not have permission to perform 
this operation 

connec t ionExcept i on - if there is a problem interacting with the CMS; this will only 
30 be thrown if the driver implementation choses to use deferred data loading (for 

performance reason). 

1 . 1 .26 Interface ItemTypeFactory 



35 public interface ItemTypeFactory 

Interacts with the CMS to provide access to item types of the CMS. 



Method Summary 


ItemType 


createNewItemType ( ) 

Creates a new ItemType instance, uninitialized, not stored in the 

CMS. 


void 


dele teltemType (ItemType itemType) 
Deletes this ItemType. 


ItemType 


getltemType (com. conceptis .util . PrimaryKey key) 
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Provides the ItemType with the specified key. 


ItemType 


getltemType (iava.lana.Strina name) 

Provides the ItemType with the specified name. 


java .util . Set 


getltemTypes ( ) 

Provides the set of all itemTypes. 


void 


saveltemType (ItemType itemType) 
Saves the specified itemType. 



Method Detail 



1.1.26.1 getltemTypes 

public java .util . Set getltemTypes ( ) 

throws ConnectionException , 

AuthorizationException 

Provides the set of all itemTypes. 
Returns: 

the set of all itemTypees (may be empty but never null) 
Throws: 

ConnectionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 



1.1.26.2 getltemType 

public ItemType getltemType (com. concept is .util . PrimaryKey key) 

throws Conne c t i onExc ep t i on , 

AuthorizationException , 
MissingResourceException 
Provides the itemType with the specified key. 
Parameters: 

key - the primary key of the ItemType 
Returns: 

the itemType with the specified key 
Throws: 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the itemType specified by the key does not exist 



1.1.26.3 getltemType 

public ItemType getltemType (java . lang. String name) 

throws ConnectionException , 

AuthorizationException , 
MissingResourceException 
Provides the itemType with the specified name. 
Parameters: 
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name - the name of the ItemType 
Returns: 

the ItemType with the specified key 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the ItemType specified by the key does not exist 



1 . 1 .26.4 createNewltemType 

public ItemType createNewltemType ( ) 

Creates a new ItemType instance, uninitialized, not stored in the CMS. Once correctly 

initialized, this instance may then be inserted in the CMS using the 

saveltemType (com, conceptis . cms . ItemType) method. 

Returns: 

the newly created ItemType 



1 . 1 .26.5 saveltemType 

public void saveltemType ( ItemType itemType) 

throws Connect ionException , 

Authori zat ionException , 
Mi s s ingResourceExcept ion 
Saves the specified itemType. This will change the item type's entry in the CMS to 
reflect the state of the itemType parameter. 
Parameters: 

itemType - the ItemType to insert/update 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing itemType does not exist any 
longer 



1 . 1 .26.6 deleteltemType 

public void deleteltemType ( ItemType itemType) 

throws Connect ionException , 

AuthorizationException , 
Mi s singRe sour ceExcept ion 
Deletes this ItemType. This may have unintended consequences. Note that some 
implementations may throw an unsupportedOperationException if the deletion of 
itemTypes is not possible. 
Parameters: 

itemType - the ItemType to delete 
Throws: 

connectionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 
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MissingResourceException - if the itemType does not exist any longer 
1 . 1 .27 Interface ItemTypeFactory 



5 public interface ItemTypeFactory 

Interacts with the CMS to provide access to item types of the CMS. 



I lVIpth nrl Sii m m am 



ItemType 


createNewItemType ( ) 

Creates a new itemType instance, uninitialized, not stored in the 

CMS. 


void 


dele teltemType (ItemType itemType) 
Deletes this ItemType. 


ItemType 


getltemType (com. conceptis . util . PrimarvKey key) 
Provides the itemType with the specified key. 


ItemType 


getltemType (iava. lanq. St rina name) 

Provides the itemType with the specified name. 


java.util .Set 


getltemTypes () 

Provides the set of all itemTypes. 


void 


saveltemType (ItemType itemType) 
Saves the specified itemType. 



Method Detail _ _ __ _ .V •■■ 

1.1.27.1 getltemTypes 

10 

public java.util. Set getltemTypes ( ) 

throws Connect ionException , 

AuthorizationException 

Provides the set of all itemTypes. 
1 5 Returns: 

the set of all itemTypees (may be empty but never null) 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
20 this operation 



1.1.27.2 getltemType 



public ItemType getltemType (com. conceptis .util . PrimaryKey key) 
25 throws Connect ionException , 
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Authorizat ionException , 

MissingResourceException 
Provides the itemType with the specified key. 
Parameters: 
5 key - the primary key of the ItemType 

Returns: 

the itemType with the specified key 
Throws: 

connectionException - if there is a problem interacting with the CMS 
1 0 Authorizat ionException - if the current user does not have permission to perform 

this operation 

MissingResourceException - if the itemType specified by the key does not exist 



1.1.27.3 getltemType 

15 

public ItemType getltemType (java . lang. String name) 

throws Conne c t i onExc ep t i on , 

Authorizat ionException , 
MissingResourceException 
20 Provides the itemType with the specified name. 

Parameters: 

name - the name of the ItemType 
Returns: 

the itemType with the specified key 
25 Throws: 

ConnectionException - if there is a problem interacting with the CMS 
Authorizat ionException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the itemType specified by the key does not exist 
30 ■ — 

1 .1 .27.4 createNewltemType 

public ItemType createNewltemType ( ) 

Creates a new itemType instance, uninitialized, not stored in the CMS. Once correctly 
35 initialized, this instance may then be inserted in the CMS using the 

saveltemType (com, conceptis . cms . ItemType) method. 
Returns: 

the newly created itemType 



40 1.1 .27.5 saveltemType 

public void saveltemType ( ItemType itemType) 

throws ConnectionException , 

Authorizat ionException , 
45 MissingResourceException 

Saves the specified itemType. This will change the item type's entry in the CMS to 

reflect the state of the itemType parameter. 

Parameters: 
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itemType - the itemType to insert/update 
Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

Mis s ingRe s our c eExcep t i on - if a previously existing ItemType does not exist any 
longer 



1 . 1 .27.6 deleteltemType 

public void deieteXtemType ( ItemType itemType) 

throws Connect ionException , 

AuthorizationException , 
MissingResourceException 
Deletes this itemType. This may have unintended consequences. Note that some 
implementations may throw an unsupportedOperationException if the deletion of 
itemTypes is not possible. 
Parameters: 

itemType - the ItemType to delete 
Throws: 

connectionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the ItemType does not exist any longer 

1 . 1 .28 Interface ObjectWithPrimaryKey 

All Known Subinterfaces: 

CmsUser , CmsUserGroup . Collection . Field , Index , Item , ItemType , PublicationStatus , 
PublishingFlow 

public interface ObjectWithPrimaryKey 



Method Summary 


■V " - '- • 

■ -„„,_.„. -m , . ...... 


| com. concept is . util . PrimaryKey 

I 


get PrimaryKey ( ) 

Provides the objects primary key. 




Method Detail 





1 . 1 .28. 1 getPrimaryKey 

public com. conceptis .util . PrimaryKey getPrimaryKey ( ) 

throws AuthorizationException 

Provides the objects primary key. 
Returns: 
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the primary key identifying the object 
Throws: 

AuthorizationException - if the user does not have permission to perform this 
operation 

5 

1 . 1 .29 Interface PublicationStatus 
All Superinterfaces: 

Obi ectWithPrimarvKe v 

1 0 public interface PublicationStatus 

4. — J _ ; inr.'ii.T*..: -rr 

A PublicationStatus is the smallest component in a PublishingFiow . 



[ ~ ' - - .. : — " " — - 

Field Summary 


I static java . lang. String 


SIGN OFF AUTOMATICALLY AFTER 




Defines a PublicationStatus that is signed off 
automatically after a given amount of time, set by 
setSignOf f Delay (long) . 


static java . lang. String 


SIGN OFF AUTOMATICALLY AT 


Defines a PublicationStatus that is signed off 
automatically at a specific moment, set by 
setSignOf f Date (java. util .Date) . 


static java . lang. String 


SIGN OFF MANUALLY 


Defines a PublicationStatus that requires a manual sign 

off. 



Method Summary 


void 


addGr oupToNo t i f y ( CmsUs erGroup group ) 


Adds a CmsUs erGroup to the list of groups that are notified when 
an item reaches this status. 


boolean 


getEmailNotif ication ( ) 

Returns the email notification status that will be used when the 
associated Item reaches this PublicationStatus. 


java .util . Set 


getGroupsToNotify ( ) 

Provides the set of all the cmsuserGroups that are sent notification 
when an item reaches this status. 


j ava . lang . String 


get Name ( ) 

Returns the name of this PublicationStatus. 


java. util. Date 


getSignOffDateO 

Deprecated, this should not be here, it is set by item 



116 



long 


gets ignOff Delay ( ) 

xveiunis tne aeiay ^in milliseconds j to wait oeiore tne item to 
which this Publicationstatus was assigned can be signed off 
automatically. 


J avd . lauy . o Li lily 


Returns the sign-off method of this Publicationstatus. 


boolean 


getSignOf f ToNewVersion () 

IVCIUI11 Liue 11 II1C aobUL/ldlCLl luem Will DC aSSlgllCU a IICW VclslOIl 

when it leaves this Publicationstatus. 


boolean 


isviewable ( ) 

ivciurns tne visiDiiiiy status 01 tne associated it em wnen n reacnes 
this Publicationstatus. 


void. 


removeGroupToNoti f y (CmsUserGroup group) 


Removes a cmsuserGroup from the list of groups that are notified 
when an item reaches this status. 


void 


setEmailNotif ication (boolean emailNotif ication) 

When set to true, an email will be sent when the associated item 
reaches this Publicationstatus. 


void 


setName (java . lang. String name) 

Sets the name of this Publicationstatus 


void 


setSignOf fDate ( java .util . Date date) 

Deprecated, this should not be here, it is set by item 


void 


secbiynui Eueiay i long aeiay ) 

Sets the delay (in milliseconds) to wait before the item to which 
this Publicationstatus was assigned can be signed off automatically. 


T/n -? H 

V U1U 


aof ci crnOf fMAhhod I H ^ 1 ana Cfri nn « i rmf)f f Mp t~ VioH \ 

O w |9 JiJJUw A- UUwU \ J O. V d . X any * » L»i -L iiy C? J- yiiu 1_ J_ 1 1C UliUU / 

Sets the sign-off method of this Publicationstatus. 


void 


setSignOff ToNewVersion {boolean signOff ToNewVersion) 

When set to true, the associated item will be assigned a new 
version when it leaves this Publicationstatus. 


void 


setViewable (boolean viewable) 

When set to true, the associated item will be viewable when it 
reaches this Publicationstatus. 



Methods inherited from interface com.conceptis.cms. QbiectWithPrimarvKev 

get Pr imaryKey 



[Field Detail 



1 .1 .29.1 SIGNJDFF JMANUALLY 

public static final java . lang. String SIGN_OFF_MANUAl,l,Y 
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Defines a Publicationstatus that requires a manual sign off. 
See Also: 

Constant Field Values 



5 1.1.29.2 S I G N_0 FF_AUTOM ATI C AL L Y_AFTE R 

public static final java . lang. String SIGN_OFF_AUTOMATICALLY_AFTER 

Defines a Publicationstatus that is signed off automatically after a given amount of 
time, set by setsignof f Delay (long) . The 
See Also: 
10 Constant Field Values 



1.1.29.3 SIGN_OFF_AUTOMATICALLY_AT 

public static final java . lang . String SIGN_OFF_AUTOMATICALLY_AT 

Defines a Publicationstatus that is signed off automatically at a specific moment, 
1 5 set by setsignof fDate (java .util. Date) . 

See Also: 

Constant Field Values 

Method Detail 

1.1.29.4 setName 

public void setName (java . lang. String name) 
20 throws AuthorizationException , 

ConnectionException 

Sets the name of this publicationstatus. 
Parameters: 

name - the name of this Publicationstatus 
25 Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
30 performance reason). 



1.1.29.5 getName 

public java . lang. String getName () 

throws AuthorizationException , 
35 ConnectionException 
Returns the name of this Publicationstatus. 
Returns: 

the name of this Publicationstatus 
Throws: 

40 Author i za t ionExcept ion - if the current user does not have permission to perform 

this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



45 
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1 .1 .29.6 setSignOff Method 

public void setSignOff Method (java . lang. String signOff Method) 

throws AuthorizationException , 
ConnectionException 
Sets the sign-off method of this Pubiicationstatus. Acceptable values are defined as 
constants in this interface and are called sign_off_xyz. Some of them may require an 
additional call to method in order to be valid. 
Parameters: 

signoff Method - one of the signoffxyz constants 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onE xc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.7 getSignOffMethod 

public java. lang. String ge t SignOff Method ( ) 

throws AuthorizationException , 
ConnectionException 
Returns the sign-off method of this Pubiicationstatus. 
Returns: 

one of the sign_off_xyz constants 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 .1 .29.8 setSlgnOffDelay 

public void setSignOff Delay ( long delay) 

throws AuthorizationException , 
ConnectionException , 
java . lang. IllegalStateException 
Sets the delay (in milliseconds) to wait before the item to which this 
Pubiicationstatus was assigned can be signed off automatically. This only applies 
to a Pubiicationstatus that has been set to sign off automatically after . 
Parameters: 

delay - the number of milliseconds to wait before the item to which this 
Pubiicationstatus was assigned can be signed off automatically 
Throws: 

java . lang. IllegalStateException - if the sign-off method doesn't support such a 
setting 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 
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1.1.29.9 getSignOffDelay 

public long getSignOffDelay ( ) 

throws Author! zationExcept ion , 
5 Connect ionExcept ion 

Returns the delay (in milliseconds) to wait before the item to which this 
Pubiicationstatus was assigned can be signed off automatically. This only applies 
to a Pubiicationstatus that has been set to sign off automatically after . 
Returns: 

1 0 the number of milliseconds to wait before the item to which this Pubiicationstatus 

was assigned can be signed off automatically 
Throws: 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

1 5 connect ionExcept ion - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.10 setSignOffDate 

public void setSignOff Date (java . util .Date date) 

throws Authorizat ionExcept ion , 
Connect ionExcept ion , 
java . lang. IllegalStateException 
Deprecated, this should not be here, it is set by item 

Sets the Dateltem to which this Pubiicationstatus was assigned can be signed off 
automatically. This only applies to a Pubiicationstatus that has been set to 

SIGN OFF AUTOMATICALLY AT . 

Parameters: 

date - the Date to reach before the item to which this Pubiicationstatus was 

assigned can be signed off automatically 

Throws: 

java . lang .IllegalStateException - if the sign-off method doesn't support such a 
setting 

Authorizat ionExcept ion - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



40 1.1.29.11 getSignOffDate 

public java. util. Date getSignOffDate ( ) 

throws Author izationException , 
Connect ionExcept ion 
Deprecated, this should not be here, it is set by item 
45 Returns the Dateltem to which this Pubiicationstatus was assigned can be signed 

off automatically. This only applies to a Pubiicationstatus that has been set to 

SIGN OFF AUTOMATICALLY AT . 

Returns: 



20 



25 



30 



35 
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the Date to reach before the item to which this Pubiicationstatus was assigned can 

be signed off automatically 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.12 setViewable 

public void setViewable (boolean viewable) 

throws AuthorizationException , 
Connect ionExcept ion 
When set to true, the associated item will be viewable when it reaches this 
Pubiicationstatus. 
Parameters: 

viewable - set to true to make the associated item visible; set to false to keep it 

invisible 

Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.13 isViewable 

public boolean isViewable () 

throws AuthorizationException , 
Conne c t i onExcep t i on 
Returns the visibility status of the associated item when it reaches this 
Pubiicationstatus. 
Returns: 

true if the associated item is visible; false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.14 setEmailNotification 

public void setEmailNotification (boolean emailNotif ication) 

throws AuthorizationException , 
Connect ionExcept ion 
When set to true, an email will be sent when the associated item reaches this 
Pubiicationstatus. 
Parameters: 
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emaiiNotif ication - set to true to send an email notification when the associated 
item reaches this Publicationstatus; set to false to disable email notification 
Throws: 

Authoriz ationException - if the current user does not have permission to perform 
this operation 

connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.15 getEmailNotification 

public boolean ge tEmailNot if ication ( ) 

throws AuthorizationException , 
ConnectionException 
Returns the email notification status that will be used when the associated item reaches 
this Publicationstatus. 
Returns: 

true if email notification is activated; false otherwise 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

Connectio nException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.16 setSignOffToNewVersion 

public void setSignOffToNewVersion (boolean signOf f ToNewVersion) 

throws AuthorizationException , 
ConnectionException 
When set to true, the associated item will be assigned a new version when it leaves 
this Publicationstatus. 
Parameters: 

signoff ToNewVersion - set to true to assign a new version to the associated item 
when it leaves this Publicationstatus; set to false to keep the same version at 
signoff 
Throws: 

Authoriz ationException - if the current user does not have permission to perform 
this operation 

connectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.17 getSignOffToNewVersion 

public boolean getSignOff ToNewVersion ( ) 

throws AuthorizationException , 
ConnectionException 
Return true if the associated item will be assigned a new version when it leaves this 
Publicationstatus. 
Returns: 
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true if new version is going to be assigned to the associated item when it leaves this 
Pubiicationstatus; false if the item will keep the same version at signofF 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne ctionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.18 addGroupToNotify 

public void addGroupToNotify ( CmsUserGroup group) 

throws AuthorizationException , 
Connect ionExcept ion 
Adds a CmsUserGroup to the list of groups that are notified when an item reaches this 
status. If the group is already being notified, this method does nothing but will not 
complain. 
Parameters: 

group - the group to be notified when an item reaches this status 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

ConnectionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.19 removeGroupToNotify 

public void removeGroupToNotify ( CmsUserGroup group) 

throws AuthorizationException , 
ConnectionException 
Removes a CmsUserGroup from the list of groups that are notified when an item 
reaches this status. 
Parameters: 

group - the group to no longer be notified when an item reaches this status 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1.1.29.20 getGroupsToNotify 

public java.util.Set getGroupsToNotify ( ) 

throws AuthorizationException , 
ConnectionException 
Provides the set of all the CmsuserGroups that are sent notification when an item 
reaches this status. 
Returns: 

the set of groups that are notified when an item reaches this status 
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Throws: 

Author i za t ionExcept ion - if the current user does not have permission to perform 
this operation 

connect ionExcept ion - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

1 . 1 .30 Interface PublicationStatusFactory 



1 0 public interface PublicationStatusFactory 

Interacts with the CMS to provide access to publication statii of the CMS. 



Method Summary 


PublicationStatus 


createNewPublicationStatus () 




Creates a new PublicationStatus instance, uninitialized, not 
stored in the CMS. 


void 


deletePublicationStatus (PublicationStatus PublicationStatus) 


Deletes this PublicationStatus. 


java.util.Set 


getPublicationStatii ( ) 

Provides the set of all Pubiicationstatuses. 


java.util.List 


getPublicationStatii (I temType type) 


Provides the List of all PublicationStatus for the specified type. 


PublicationStatus 


getPublicationStatus (com. concept is .util . PrimaryKey key) 




Provides the PublicationStatus with the specified key. 


void 


savePublicationStatus (PublicationStatus PublicationStatus) 


Saves the specified PublicationStatus. 



Method Detail 



1 .1 .30.1 getPublicationStatii 
15 public java.util.Set getPublicationStatii { ) 

throws Connect ionExcept ion , 

Authorizat ionExcept ion 
Provides the set of all Pubiicationstatuses. ~* 
Returns: 

20 the set of all Pubiicationstatuses 

Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 

Author i za t ionExcept ion - if the current user does not have permission to perform 

this operation 



25 
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1 .1 .30.2 getPublicationStatii 

public java .util .List g tPublicationStatii ( ItemType type) 

throws Conne c t i onExc ep t i on , 

AuthorizationException 
Provides the List of all Pubiicationstatus for the specified type. Authorization 
required: Action.READ on the supplied ItemType 
Parameters: 

type - the type to provide the statii for 
Returns: 

the List of status objects associated with the provided type 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the user does not have permission to perform this 
operation 



1 .1 .30.3 getPublicationStatus 
public Pubiicationstatus 

getPublicationStatus (com. concept is .util . PrimaryKey key) 

throws Connect ionExcept ion , 

AuthorizationException , 
MissingResourceException 

Provides the pubiicationstatus with the specified key. 
Parameters: 

key - the primary key of the Pubiicationstatus 
Returns: 

the Pubiicationstatus with the specified key 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

Miss ingRe s our c eExcep t i on - if the Pubiicationstatus specified by the key does 
not exist 



1 .1 .30.4 createNewPublicatlonStatus 

public Pubiicationstatus createNewPublicatlonStatus ( ) 

Creates a new Pubiicationstatus instance, uninitialized, not stored in the CMS. 
Once correctly initialized, this instance may then be inserted in the CMS using the 
savePublicationStatus (com. conceptis . cms . Pubiicationstatus) method. 
Returns: 

the newly created Pubiicationstatus 



1 .1 .30.5 savePublicationStatus 

public void savePublicationStatus ( Publ icationStatus pubiicationstatus) 

throws Connect ionExcept ion , 

Author izat ionExcept ion , 
MissingResourceException 

Saves the specified Pubiicationstatus. This will change the Pubiicationstatus' 

entry in the CMS to reflect the state of the pubiicationstatus parameter. 
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Parameters: 

publicationstatus - the Publi cations tatus to insert/update 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
5 Authorizat ionExcept ion - if the current user does not have permission to perform 

this operation 

Miss ingRe sour ceExcept ion - if a previously existing Publicationstatus does not 
exist any longer 



1 0 1 .1 .30.6 deletePublicationStatus 

public void deletePublicationStatus ( Publicationstatus publicationstatus) 

throws Connect ionExcept ion , 

Authorizat ionExcept ion , 
Mi ssingResour ceExcept ion 
1 5 Deletes this Publicationstatus. This may have unintended consequences. Note that 

some implementations may throw an unsupportedOperationException if the 
deletion of Publicationstatuses is not possible. 
Parameters: 

publicationstatus - the Publicationstatus to delete 
20 Throws: 

Connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the Publicationstatus does not exist any longer 

25 

1.1.31 Interface PublishingFlow 

All Superinterfaces: 

Obi ectWithPrimarvKe v 



30 public interface PublishingFlow 

extends Obi ectWithPrimarvKe v 

A PublishingFlow describes a sequence, order and relations, of any number of 
Publicationstatus . Such a flow can be assigned to an itemType to constrain its publishing 
flow. 

35 — — — — —=—=— 



Method Summary 


void 


addPublicationS tatus (int index, 
Publicationstatus publicationstatus) 

Adds a Publicationstatus to this PublishingFlow at the 
specified index. 


java . lang. String 


getName ( ) 

Returns the name of this PublishingFlow. 


java .util . List 


getPublicationStatii { ) 

Provides the PublicStatus objects that make up this flow. 
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PublicationStatus 


getPublicationStatus (int index) 




Returns the PublicationStatus found at the specified index in 
this PublishingFlow. 


boolean 


isCircular () 

Returns true if this PubiicationFlow is circular; false otherwise. 


PublicationStatus 


removePub Ilea t ion Status ( Publ icationStatus publicat ionStatus ) 




Removes the PublicationStatus found at the specified index in 
this PublishingFlow. 


void 


setcircular (boolean circular) 

If set to true, this PublishingFlow will be circular, which means 
that once the last PublicationStatus is reached and the item is being 
signed off, it will start over at the first PublicationStatus. 


void 


setName (java . lang . String name) 

Sets the name of this PublishingFlow. 



Methods inherited from interface com.conceptis.cms.ObiectWithPrimai^Key 

get Pr imaryKey 



1.1.31.1 setName 

public void setName (java . lang. String name) 
5 throws Author izationException , 

ConnectionException 

Sets the name of this PublishingFlow. 

Parameters: 

name - the name of this PublishingFlow 
1 0 Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
1 5 performance reason). 



1.1.31.2 getName 

public java . lang. String getName () 

throws AuthorizationException , 
20 ConnectionException 

Returns the name of this PublishingFlow. 

Returns: 

the name of this PublishingFlow 
Throws: 
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AuthorizationException - if the current user does not have permission to perform 
this operation 

connect ionException - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
5 performance reason). 



1.1.31.3 addPublicationStatus 

public void addPublicationStatus (int index, 

PublicationStatus publicationStatus) 
10 throws AuthorizationException , 

j ava . lang . IndexOutOf BoundsExcept ion 
Adds a PublicationStatus to this PublishingFlow at the specified index. 
Parameters: 

1 5 index - index at which the PublicationStatus is to be inserted 

publicationStatus - PublicationStatus to insert in the PublishingFlow 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

20 c onne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang . mdexOutof BoundsException - if the index is negative or larger then the 
current field count 

25 

1 .1 .31 .4 getPublicationStatus 

public PublicationStatus getPublicationStatus (int index) 

throws Authori zat ionException , 
Connect ionException, 

30 

java . lang. IndexOutOf BoundsException 

Returns the PublicationStatus found at the specified index in this PublishingFlow. 
Parameters: 

index - index at which the PublicationStatus is stored 
35 Returns: 

the PublicationStatus found at the specified index 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

40 Conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 

be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

java . lang . IndexOutOf BoundsException - if the index is negative or larger then the 
current field count 

45 

1 .1 .31 .5 removePublicationStatus 
public PublicationStatus 

removePublicationStatus ( PublicationStatus publicationStatus) 
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throws AuthorizationException , 
Conne c t i onExc ep t i on 
Removes the Publicationstatus found at the specified index in this 
PublishingFlow. 
Parameters: 

publicationstatus - the Publicationstatus to remove 
Returns: 

the removed Publicationstatus 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 



1 .1 .31 .6 getPublicationStatii 

public java.util.List getPublicationStatii ( ) 

throws AuthorizationException , 
ConnectionException 
Provides the PublicStatus objects that make up this flow. These objects 
are returned in a List in the order of the publication flow. There may 
be duplicate elements. 
Returns s 

the publication statii, in order of flow 
Throws t 

AuthorizationException - if the current user does not have permission 
to perform this operation 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS; 
this will only be thrown if the driver implementation choses to use 
deferred data loading (for performance reason) . 



1.1.31.7 setCircular 

public void setCircular (boolean circular) 

throws AuthorizationException , 
ConnectionException 
If set to true, this PublishingFlow will be circular, which means that 
once the last Publicationstatus is reached and the Item is being 
signed off, it will start over at the first Publicationstatus. 
Parameters i 

circular - set to true for a circular behavior; set to false for 
simple linear behavior 
Throws t 

AuthorizationException - if the current user does not have permission 
to perform this operation 

Conn e c t i onExc ep t i on - if there is a problem interacting with the CMS; 
this will only be thrown if the driver implementation choses to use 
deferred data loading (for performance reason) . 



1 .1 .31 .8 isCircular 
public boolean isCircular () 

throws AuthorizationException , 
ConnectionException 
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Returns true if this PublicationFlow is circular; false otherwise. 
Returns s 

true if this PublicationFlow is circular; false otherwise 
Throws t 

5 AuthorizationException - if the current user does not have permission 

to perform this operation 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS; 
this will only be thrown if the driver implementation choses to use 
deferred data loading (for performance reason) . 

10 

1 .1 .32 Interface PublishingFlowFactory 
public interface PublishingFlowFactory 

Interacts with the CMS to provide access to publication flows of the CMS. 



Method Summary 

! „ . ~ t . - 


! PublishingFlow 


createNewPublishingFlow ( ) 




Creates a new PublishingFlow instance, uninitialized, not stored in 
the CMS. 


void 


deletePublicationStatus (PublishingFlow publishinqFlow) 


Deletes this PublishingFlow. 


PublishingFlow 


getPublishingFlow(com. concept is . util . PrimarvKev kev) 




Provides the PublishingFlow with the specified key. 


java .util .Set 


getPublishingFlows () 

Provides the set of all PublishingFlows. 


void 


savePublishingFlow (PublishingFlow publishingFlow) 


Saves the specified PublishingFlow. 



Method Detail 



ill 



1.1 .32.1 getPublishingFlows 

public java. util .Set getPublishingFlows ( ) 

throws Connect ionExcept ion , 
20 AuthorizationException 
Provides the set of all PublishingFlows. 
Returns: 

the set of all PublishingFlows 
Throws: 

25 connect ionExcept ion - if there is a problem interacting with the CMS 

AuthorizationException - if the current user does not have permission to perform 
this operation 
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1 .1 .32.2 getPublishingFlow 

public PublishingFlow getPublishingFlow (com. concept is .util . PrimaryKey key) 

throws Conne c t ionExc ep t i on , 

AuthorizationException , 
5 MissingResourceException 
Provides the PublishingFlow with the specified key. 
Parameters: 

key - the primary key of the PublishingFlow 
Returns: 

1 0 the PublishingFlow with the specified key 

Throws: 

*- J tti *- J i -T 4-X% Ir. « w . A U1 nw ~4.1— ,Z*.t~ J-l OTk iTO 

v^u/Aj.iic^ u xmiDAue^ i .mix - ia uiwic la a piuuitm initialling Willi llic ^IVIO 

AuthorizationException - if the current user does not have permission to perform 
this operation 

1 5 Mi s s ingRe sour ceExcept ion - if the PublishingFlow specified by the key does not 

exist 

1.1.32.3 createNewPublishingFlow 

public Publ ishingFlow createNewPublishingFlow ( ) 

20 Creates a new PublishingFlow instance, uninitialized, not stored in the CMS. Once 

correctly initialized, this instance may then be inserted in the CMS using the 
savePublishingFlow (com, conceptis . cms . PublishingFlow) method. 
Returns: 

the newly created PublishingFlow 
25 __ __ 

1 . 1 .32.4 savePublishingFlow 

public void savePublishingFlow ( PublishingFlow publishingFlow) 

throws Connect ionExcept ion , 

AuthorizationException , 
30 Miss ingRe sourceExcep t ion 

Saves the specified PublishingFlow. This will change the PublishingFlow f s entry in 

the CMS to reflect the state of the publishingFlow parameter. 

Parameters: 

publishingFlow - the PublishingFlow to insert/update 
35 Throws: 

connect ionException - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if a previously existing PublishingFlow does not exist 
40 any longer 

1 .1 .32.5 deletePublicationStatus 

public void deletePublicationStatus ( PublishingFlow publishingFlow) 

throws Conne c t ionExc ep t i on , 
45 Author i zat ionException , 

MissingResourceException 
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Deletes this PublishingPiow. This may have unintended consequences. Note that 
some implementations may throw an unsupportedoperationException if the 
deletion of PubiishingFiows is not possible. 
Parameters: 

publishingFlow - the PublishingFlow to delete 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

MissingResourceException - if the PublishingFlow does not exist any longer 
1 .1 .33 Interface Relationship 



public interface Relationship 

Links an item relationship with a List of parameters. 



Method Summary 


| java.util . Iterator 

i 

! 


getParameterNames ( ) 

Provides names of the parameters in this relationship. 


java.util. List 


ge tParame terValues ( i ava . lane? . S t r incr name ) 

Provides the values of the parameter specified (a list of strings). 


Item 


getRelation () 

Provides the related item. 



Method Detail 

1.1.33.1 getRelation 

public Item getRelation ( ) 

throws Connect ionException , 

AuthorizationException , 
MissingResourceException 
Provides the related item. 
Returns: 

the item that is in the relationship 
Throws: 

AuthorizationException - if the current user does not have permission to perform 
this operation 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS; this will only 
be thrown if the driver implementation choses to use deferred data loading (for 
performance reason). 

MissingResourceException - is the item in the relationship does not exist 
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1 . 1 .33.2 getParameterNames 

public java.util. Iterator getParameterNames ( ) 

Provides names of the parameters in this relationship. 
Returns: 

5 the names of the parameters 



1 .1 .33.3 getParameterValues 

public java.util. List getParameterValues (java . lang. String name) 
Provides the values of the parameter specified (a list of strings). 
1 0 Parameters: 

name - the name of the parameter 
Returns: 

the values of the specified parameter (a list of strings) 
15 1.1.34 Interface RelationType 



public interface RelationType 

A RelationType defines any kind of relation that may exist between two items: parent/child, 
article/author, text/image, etc. Relations may or may not be bilateral, meaning that a relation 
20 may be called differently depending on the point of origin (ex: parent/child). Relations may 
also be of the following types: 1-to-l, 1-to-many or many-to-many. 



Field Summary 




static java lang. String 


CHILD 

Defines a RelationType that can be used to link non- 
unique child items to another item. 


static java. lang. String 


DESCENDANT 

Defines a RelationType that can be used to link non- 
unique child items to another item. 


static java . lang. String 


PARENT 

Defines a RelationType that can be used to link non- 
unique parent items to another item. 


static java. lang. String 


PRIMARY PARENT 

Defines a RelationType that can be used to link a unique 
parent item to another item. 


static java. lang. String 


SECONDARY PARENT 

Defines a RelationType that can be used to link a parent 
item to another item. 



Method Summary 
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j ava . lang . String 


getName ( ) 

Returns the name of this ReiationType. 


boolean 


isManda tory ( ) 

Indicates whether the ReiationType must be set. 


boolean 


isUnique ( ) 

Returns true if the item can only have one unique item linked to 
it using this ReiationType; returns false if an item may have one or 
more other items linked to it using this ReiationType. 



Field Detail 



1.1 .34.1 P R I M AR Y_P ARE NT 

public static final j ava . lang. String PRIMARY_PARENT 

Defines a ReiationType that can be used to link a unique parent item to another item. 
5 This is the reciprocal of child . 

See Also: 

Constant Field Values 



1.1.34.2 PARENT 

10 public static final j ava . lang. String PARENT 

Defines a ReiationType that can be used to link non-unique parent items to another 
item. This is the reciprocal of child . 
See Also: 

Constant Field Values 

15 ___ 

1.1.34.3 SECONDARY_PARENT 

public static final j ava . lang . String SECOND ary_parent 

Defines a ReiationType that can be used to link a parent item to another item. This is 
the reciprocal of child . 
20 See Also: 

Constant Field Values 



1.1.34.4 CHILD 

public static final j ava . lang. String CHILD 
25 Defines a ReiationType that can be used to link non-unique child items to another 

item. This is the reciprocal of primary parent and parent . 
See Also: 

Constant Field Values 



30 1.1.34.5 DESCENDANT 

public static final j ava . lang . String DESCENDANT 
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Defines a RelationType that can be used to link non-unique child items to another 

Item. 

See Also: 

Constant Field Values 

[ Method Detail _ ______ ________ _ _ 

5 1.1.34.6 getName 

public java . lang. String getName () 

Returns the name of this RelationType. 
Returns: 

the name of this RelationType 



1.1.34.7 isUnique 

public boolean isUnique ( ) 

Returns true if the item can only have one unique item linked to it using this 
RelationType; returns false if an item may have one or more other items linked to it 
1 5 using this RelationType. 

Returns: 

true for unique linked item; false for multiple linked items 



1.1.34.8 isMandatory 
20 public boolean isMandatory ( ) 

Indicates whether the RelationType must be set. 
Returns: 

true if the relation is mandatory, false otherwise 
25 1.1.35 Interface RelationTypeFactory 



public interface RelationTypeFactory 

Interacts with the CMS to provide access to the relation types of the CMS. 



Method Summary 

■ - 


RelationType 


getRelationType (ItemType type, j ava . lanq . Strinq name) 




Provides the RelationType with the specified name and uniqueness. 


RelationType 


getRelationType (lava. lanq. Strinq type, lava . lanq. Strinq name) 




Provides the RelationType with the specified name and uniqueness. 


java .util . Set 


getRelationTypes (ItemType type) 

Provides the set of all RelationTypeS. 


boolean 


relationshipPermitted ( j ava . lang . String itemTypel , 
java . lang . String itemType2, java . lang . String name) 
Indicates whether two items are linkable. 
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Method Detail 



1 .1 .35.1 getRelationTypes 

public java .util . Set getRelationTypes ( ItemType type) 

throws ConnectionExcept ion , 
5 AuthorizationException 

Provides the set of all ReiationTypes. 

Parameters: 

type - the ItemType of the item seeking a list of possible relationship types 
Returns: 

1 0 the set of all ReiationTypes (may be empty but never null) 

Throws: 

c onne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 



15 



1 . 1 .35.2 getRelationType 

public RelationType getRelationType ( ItemType type, 

java . lang. String name) 
throws Connect ionExcept ion , 
20 AuthorizationException , 

MissingResourceException 

Provides the RelationType with the specified name and uniqueness. 
Parameters: 

type - the ItemType of the item seeking a relationship 
25 name - the name of the relation 

Returns: 

the RelationType matching the specified parameters 
Throws: 

conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
30 AuthorizationException - if the current user does not have permission to perform 

this operation 

MissingResourceException - if the RelationType specified by the parameters does 
not exist 



35 1.1.35.3 getRelationType 

public RelationType getRelationType (java . lang. String type, 

java . lang. String name) 
throws Connect ionExcept ion , 

AuthorizationException , 
40 MissingResourceException 

Provides the RelationType with the specified name and uniqueness. 
Parameters: 

type - the name of ItemType of the item seeking a relationship 
name - the name of the relation 
45 Returns: 
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the RelationType matching the specified parameters 
Throws: 

Conne c t i onExc ep t i on - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
5 this operation 

Miss ingResour ceExcept ion - if the RelationType specified by the parameters does 
not exist, or the itemType does not exist 



1.1.35.4 relationshipPermitted 

public boolean relationshipPermitted (java . lang. String itemTypel, 

java. lang. String itemType2, 
java . lang. String name) 
throws Connec t ionExcept ion , 

AuthorizationException , 
MissingResourceException 
Indicates whether two items are linkable. 
Parameters: 

itemTypel - the first item type 
itemType2 - the second item type 
name - the name of the relationship 
Returns: 

true if the items are linkable, false otherwise 
Throws: 

connect ionExcept ion - if there is a problem interacting with the CMS 
AuthorizationException - if the current user does not have permission to perform 
this operation 

m i s s i ngRe s our c eExc ep t i on - if the RelationType specified by the parameters does 
not exist, or the itemType does not exist 

30 1.1.36 Interface SecurityManager 



public interface SecurityManager 

The SecurityManager centralizes all the business logic of your driver related to access 
restrictions. Indeed, most of the actions that can be performed by a cmsuser when using the 
35 CMS Driver may need to be approved before being executed. 

This Interface must be implemented by your application in order to define your own business 
logic, and you must then tell the driver that you will use your own implementation using the 
driver configuration file. 



Method Summary 


boolean 


isAllowed (CmsUser cmsUser, Action action, Item item, Field field) 


This feature is not supported in this version of the CMS API, and will always 
throw an Un support edOperat ionExcept ion. 


boolean 


isAllow d (CmsUser cmsUser, Action action, java . lang . Object resource) 



10 
15 

20 

25 
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Checks if the cmsuser can perform the Action on the given 
SecureResource. 



Method Detail 



1.1.36.1 isAllowed 

public boolean isAllowed ( CmsUser cmsUser, 



5 java . lang .Obj ect resource) 

Checks if the CmsUser can perform the Action on the given SecureResource. 
Parameters: 

cmsUser - the CmsUser that wants to execute the specified Action on the given 
resource. 

1 0 action - the Action that will be performed by the cmsUser on the given resource, if 

authorized. 

resource - the Obj ect on which the specified Action will be performed if 

authorization is granted. 

Returns: 

1 5 true if the given cmsuser has enough credentials to perform the action on the 

resource. 



1.1.36.2 isAllowed 

public boolean isAllowed ( CmsUser cmsUser, 
20 Action action, 

Item item, 
Field field) 

This feature is not supported in this version of the CMS API, and will always throw an 
UnsupportedOperationException. 

25 Checks if the CmsUser can perform the Action on the Field of the given item. 

Parameters: 

cmsUser - the CmsUser that wants to execute the specified action on the given item, 
action - the Action that will be performed by the CmsUser on the given item, if 
authorized. 

30 item - the item on which the specified Action will be performed if authorization is 

granted. 

field - the Field of the item that will be accessed when performing the specified 

action. 

Returns: 

35 true if the given CmsUser has enough credentials to perform the Action on the Field 

of the Item. 
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1.1.37 Interface Version 



public interface Version 

A version represents a modification applied to an item . 



I Method Summary 



CmsUser 


get Author ( ) 

Returns the Author of this version. 


java .util .Date 


getDate () 

Returns the Date of this version. 


java . lang .String 


getNote ( ) 

Return the text note associated with this version. 


PublicationStatus 


getPublicationStatus () 




Returns the PublicationStatus of this Version. 


long 


getVersion (} 

Returns the current version number of this version. 



" ; ^ „,„_„™™ . „ . 

1.1.37.1 getVersion 

public long getVersion () 

throws Aut hor i za t ionExcept ion 
1 0 Returns the current version number of this version. 

Returns: 

the current version number of this version 
Throws: 

Author izat ionExcept ion - if the user does not have permission to perform this 
1 5 operation 



1.1.37.2 getNote 

public java. lang. String getNote () 

throws Author izat ionExcept ion 
20 Return the text note associated with this version. 

Returns: 

the text note associated with this version 
Throws: 

AuthorizationException - if the user does not have permission to perform this 
25 operation 
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1 .1 .37.3 getPublicationStatus 

public Publications tatus getPublicationStatus ( ) 

throws AuthorizationException 
Returns the PublicationStatus of this Version. 
5 Returns: 

the PublicationStatus of this Version 
Throws: 

AuthorizationException - if the user does not have permission to perform this 
operation 

10 

A A O ~~7 A A A . . J-l 

i.i.Of.t ycirtuu iui 

public CmsUser getAuthorO 

throws AuthorizationException 
Returns the Author of this Version. 
1 5 Returns: 

the Author of this Version 
Throws: 

AuthorizationException - if the user does not have permission to perform this 
operation 

20 — — — 

1.1.37.5 getDate 

public java.util.Date getDate {) 

throws AuthorizationException 
Returns the Date of this Version. 
25 Returns: 

the Date of this Version 
Throws: 

AuthorizationException - if the user does not have permission to perform this 
operation 

30 

1 .2 PACKAGE COM.CONCEPTIS.CMS.FILTER 
1 .2. 1 Class CmsUserUsernameComparator 

j ava . lang . Ob j ect 

35 +- -com. concept is .cms . filter .CmsUserUsernameComparator 

All Implemented Interfaces: 

java.util.Comparator 



public class CmsUserUsernameComparator 

40 extends java.lang.Object 

implements java.util.Comparator 

Comparator that utilizes a user's username to sort a collection of users. 



Field Summary 
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private boolean 


ascending 

Whether to sort ascending or descending. 


private 

static org. apache . log4j . Logger 


log 

For logging purposes. 



| Constructor Summary 

I CmsUserUsernameComparator ( ) 



h . ' . ■[.,.:":. ,■:■ ', = ■::■&■■£-. ;r : , .. ":•/. r:::\.. ~ :: ~~ ■ . . • . 

Method Summary 



int 


compare (java. lang. Object ol, java . lang. Object o2) 
Compares its two arguments for order. 


boolean 


isAscending ( ) 

Indicates whether the comparator is sorting in an ascending or descending 
manner. 


void 


setAscending (boolean ascending) 

Sets whether the comparator is sorting in an ascending or descending manner. 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Methods inherited from interface java. util. Comparator 



equals 



Field Detail 

1.2.1.1 log 

private static org. apache . log4j . Logger log 
For logging purposes. 



10 1.2.1.2 ascending 

private boolean ascending 
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Whether to sort ascending or descending. 

Constructor Detail 



1 .2.1 .3 CmsUserUsernameComparator 
public CmsUserUsernameComparator ( } 

[Method Detail " ; ~ 



1.2.1.4 isAscending 
5 public boolean isAscending ( ) 

Indicates whether the comparator is sorting in an ascending or descending manner. 
Returns: 

true if the comparator is ascending, false if descending 



10 1.2.1.5 setAscending 

public void setAscending (boolean ascending) 

Sets whether the comparator is sorting in an ascending or descending manner. 
Parameters: 

ascending - true if the comparator is ascending, false otherwise 
15 — — 

1.2.1.6 compare 

public int compare (java . lang .Ob j ect ol, 

java. lang. Object o2) 
throws j ava . lang . ClassCas tExcep tion 
20 Compares its two arguments for order. Returns a negative integer, zero, or a positive 

integer as the first argument is less than, equal to, or greater than the second. 
Specified by: 

compare in interface java.util .Comparator 
Parameters: 
25 oi - the first object to be compared 

02 - the second object to be compared 
Returns: 

a negative integer, zero, or a positive integer as the first argument is less than, equal to, 
or greater than the second 
30 Throws: 

java . lang . ciassCastException - if the arguments' types prevent them from being 
compared by this Comparator 

1 .2.2 Class DateAwareItemNameComparator 

35 j ava . lang . Ob j ect 

i 

+ - - com • concept is . cms . filter . DateAwareItemNameComparator 
All Implemented Interfaces: 

java.util.Comparator 

40 • _____ . 

public class DateAwareItemNameComparator 

extends java.lang.Object 
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implements java.util.Comparator 

Comparator that is able to compare an item's names. If there is a date in the name, this is used 
to sort, but in reverse order (so, alphabetically ascending, but numerically descending, or the 
opposite). 



Field Summary 


private boolean 


da teAsc ending 

The order to sort the date. 


private boolean 


nameAsc ending 

The order to sort the name. 


private 

static java .util . regex. Pattern 


pattern 

The compiled pattern. 


static java . lang. String 


YEAR PATTERN 

The pattern to recognize years. 



Constructor Summary 

„;!._. ; - " L ± ... .... _ ... . . ■•: ...... 



Date Aware I temNameCompara tor ( ) 

Creates a comparator that sorts the name ascending, date descending. 



DateAwareltemNameComparator (boolean nameAsc ending, boolean dateAscending) 



Creates a comparator. 



Method 


nummary 




int 


compare (java. lang. Object ol, java. lanq. Object o2) 
Compares two objects, which maybe items or Dates. 





Methods inherited from class java.Iang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



(Methods inherited from interface java.util.Comparator 



equals 
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(Field Detail 




1.2.2.1 nameAscending 
private boolean nameAscending 
The order to sort the name. 




5 


1 .2.2.2 dateAscending 
private boolean dateAscending 
The order to sort the date. 




10 


1 .2.2.3 YEAR_PATTERN 

public static final java . lang . String YEARPATTERN 
The pattern to recognize years. 
See Also: 

Constant Field Values 




15 


1.2.2.4 pattern 

private static java .util . regex. Pattern pattern 
The compiled pattern. 






Constructor Detail 




20 


1 .2.2.5 DateAwareltemNameComparator 
public DateAwareltemNameComparator { ) 

Creates a comparator that sorts the name ascending, date descending. 




25 


1 .2.2.6 DateAwareltemNameComparator 

public DateAwareltemNameComparator (boolean nameAscending, 

boolean dateAscending) 

Creates a comparator. 
Parameters: 

nameAscending - true to sort the name ascending, false descending 
dateAscending - true to sort the date ascending, false descending 




Method Detail 


30 


1.2.2.7 compare 

public int compare (java. lang. Object ol, 

java. lang. Object o2) 
throws j ava . lang . ClassCastException 

Compares two objects, which may be items or Dates. 





Specified by: 

35 compare in interface j ava . ut il . Comparator 

Parameters: 

01 - the first object to compare 

02 - the second object to compare 
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Returns: 

a negative integer, zero, or a positive integer as the first argument is less than, equal to, 

or greater than the second 

Throws: 

5 j ava . lang . classCas tExcept ion - if the arguments 1 types prevent them from being 

compared by this Comparator 

1 .2.3 Class ItemDateRangeFilter 

j ava . lang . Ob j ect 

10 | 

+ --COm, conceptis .util - filter .AbstractFilter 

I 

+- -com. conceptis .util . filter . RangeFilter 

1 

1 O + - - com. conceptis . cms . filter . ItemDateRangeFilter 

All Implemented Interfaces: 

com.conceptis.util.filter.Filter 
Direct Known Subclasses: 

ItemFieldDateRangeFilter , ItemLastModificationDateFilter 

20 ^ 

public class ItemDateRangeFilter 

extends com.conceptis.util.filter.RangeFilter 

Filters a collection of items using a date range. 



Field Summary 

v. * 


- ; . m m- ■ 


static j ava . lang. String 


DEFAULT PATTERN 

The default (SimpleDateFormat pattern for 
interpreting dates: dd mm yyyy HH:mm:ss. 


private 

j ava . text . SimpleDateFormat 


format 

The SimpleDateFormat used to interpret dates. 


private java . util . Locale 


locale 

The locale used to interpret dates. 


private 

static java .util . regex. Pattern 


localeRegex 

The regular expression to parse the Locale string. 


private 

static org . apache . log4j . Logger 


log 

For logging purposes. 


private j ava . lang . String 


pattern 

The pattern used to interpret dates. 



25 



Fields inherited from class com.conceptis.util.filter.RangeFilter 
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Constructor Summary 

ItemDateRangeFllter ( ) 



Method Summary i . , . i_ , • . — jl _ _ . „ _ 


java . lang. String 


getEndDate { ) 

Provides the ending date range. 


j ava . lang . String 


getLocale ( ) 

Provide the locale used to interpret dates. 


j ava . lang . String 


getPattern ( ) 

Provides the pattern used to interpret dates. 


java . lang. String 


getStartDate () 

Provides the starting date range. 


java .util . Locale 


parseLocale (java. lang. String locale) 

Generates a locale from a string provided be a locales tostring 
method. 


void 


setEndDate (java . lang . String end) 
Sets the ending date range. 


void 


setLocale ( j ava . lang . String locale) 
Sets the locale used to interpret dates. 


void 


setPattern (java . lang. String pattern) 
Sets the pattern used to interpret dates. 


void 


setStartDate (java . lang. String start) 
Sets the starting date range. 



Methods inherited from class com.conceptis.util.filter.RangeFilter 

filter, get Comparator, getEnd, getStart, islnclusive, islnside, 
setComparator, setEnd, setlnclusive, setlnside, setStart 



Methods inherited from class com.conceptis.u til.filter. AbstractFilter 

filter 



5 



Methods inherited from class java.lang.Object 



146 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Field D etatt ' / J 

1 .2.3.1 DE FAU LT_PATTERN 

public static final java . lang. String DEFAULTPATTERN 

The default (SimpleDateFormat pattern for interpreting dates: dd mm yyyy HH:mm:ss. 
5 See Also: 

Constant Field Values 



1.2.3.2 localeRegex 

private static java .util .regex. Pattern localeRegex 
1 0 The regular expression to parse the Locale string. 



1.2.3.3 log 

private static org. apache . log4j . Logger log 
For logging purposes. 

15 

1.2.3.4 locale 

private java . util . Locale locale 

The locale used to interpret dates. 



20 1.2.3.5 pattern 

private java . lang . String pattern 

The pattern used to interpret dates. 



1.2.3.6 format 
25 private java . text . SimpleDateFormat format 

The SimpleDateFormat used to interpret dates. 

Constructor Detail 

1 .2.3.7 ItemDateRangeFilter 
public ItemDateRangeFilter ( ) 

^.^ r ^^w~ r > rpww « g ^..«^.»^* — ^ ■■ v .. v ,^ . ^ ? ^,,^.v,^. rr ,, «■?•:•••'". ^ rr^;;-.^^^^;:'' "--"^v^:- ... " ■■''" -■■■::s:r:- L -"'''Z -..!!: " " ~T ' •'•/ 

jMethod Detail - J j _ [_ 

1.2.3.8 getLocale 

30 public java. lang. String getLocale ( ) 

Provide the locale used to interpret dates. 
Returns: 

the locale used to interpret dates 
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1.2.3.9 setLocale 

public void setLocale ( java . lang . String locale) 
Sets the locale used to interpret dates. 
Parameters: 

locale - the locale used to interpret dates 



1.2.3.10 parseLocale 

public java .util . Locale parseLocale ( java . lang . String locale) 

Generates a locale from a string provided be a locale's tostring method. 
Parameters: 

locale - a string representing a locale 
Returns: 

a locale as specified by the string 



1.2.3.11 getPattern 

public j ava . lang . String getPattern () 

Provides the pattern used to interpret dates. 
Returns: 

the pattern used to interpret dates 



1.2.3.12 setPattern 

public void setPattern (java . lang . String pattern) 
Sets the pattern used to interpret dates. 
Parameters: 

pattern - the pattern to use 



1.2.3.13 getStartDate 

public java . lang. String getStartDate ( ) 
Provides the starting date range. 
Returns: 

the starting date range 



1.2.3.14 setStartDate 

public void setStartDate (java . lang . String start) 
throws j ava . text . Par seExcep t ion 
Sets the starting date range. 
Parameters: 

start - the starting date range 
Throws: 

j ava . text . ParseException - if the date cannot be parsed 



1.2.3.15 getEndDate 

public java . lang. String getEndDate () 
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Provides the ending date range. 
Returns: 

the ending date range 



5 1.2.3.16 setEndDate 

public void setEndDate (java . lang . String end) 

throws j ava . text . ParseExcept ion 
Sets the ending date range. 
Parameters: 
1 0 end - the ending date range 

Throws: 

java . text . ParseExcept ion - if the date cannot be parsed 
1 .2.4 Class ItemFieldDateComparator 

15 java . lang. Object 

I 

+ - - com. concep tis . cms . filter . ItemFieldDateComparator 
All Implemented Interfaces: 

java.util.Comparator 

20 — — — 

public class ItemFieldDateComparator 

extends java.lang.Object 
implements java.util.Comparator 

Comparator that is able to compare an item's field value to a Date. 
25 ^ — — — - — — __ __ 



Field Summary 




private java . lang . String 


f ieldName 

The field name to compare to. 


private 

static org . apache . log4 j . Logger 


log 

For logging purposes. 



Constructor Summary ^Sl^fl^SlPP 

, „ *t 

\ ItemFieldDateComparator ( ) 



Method Summary 


int 


compare (java . lang. Object ol, java.lang.Object o2) 


Compares two objects, which may be items or Dates. 
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j ava . lang . String 


getFieldName ( ) 

Provides the field name to use in the comparison. 


void 


setFieldName ( java . lang . String f ieldName) 
Sets the field name to use in the comparison. 



Methods inherited from class java.lang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Methods inherited from interface java.util.Comparator 



equals 



Field Detail 



1.2.4.1 log 

5 private static org . apache . log4j . Logger log 
For logging purposes. 



1.2.4.2 fieldName 

private j ava . lang . String fieldName 
1 0 The field name to compare to. 



Constructor Detail ■ U _r v_J 



1 .2.4.3 ItemFieldDateComparator 
public ItemFieldDateComparator ( ) 



Method Detail 

!■>':: . --=-■ : ■ ...... .. 



1 .2.4.4 getFieldName 

public java . lang. String getFieldName ( ) 
1 5 Provides the field name to use in the comparison. 

Returns: 

the field name to use in the comparison 



1 .2.4.5 setFieldName 
20 public void setFieldName (java. lang. String fieldName) 
Sets the field name to use in the comparison. 
Parameters: 
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f ieldName - the fieldName to use in the comparison 



1 .2.4.6 compare 

public int compare (java . lang. Object ol, 
5 java . lang. Object o2) 

throws java . lang. ClassCastExcept ion 

Compares two objects, which may be items or Dates. 

Specified by: 

compare in interface java . util . Comparator 
10 Parameters: 

01 - the first object to compare 

02 - the second object to compare 
Returns: 

a negative integer, zero, or a positive integer as the first argument is less than, equal to, 
15 or greater than the second 

Throws: 

java . lang. classCastException - if the arguments' types prevent them from being 
compared by this Comparator 

20 1 .2.5 Class ItemFieldDateRangeFilter 

j ava . lang . Ob j ec t 

I 

+--com. conceptis .util . filter . AbstractFilter 

1 

25 +--com. concept is. util . filter . RangeFilter 

I 

+ - - com. conceptis . cms . filter . ItemDateRangeFilter 

+ - -com. conceptis . cms . filter . ItemFieldDateRangeFilter 
30 All Implemented Interfaces: 

com.conceptis.util.filter.Filter 



public class ItemFieldDateRangeFilter 

extends ItemDateRangeFilter 

35 Filters a collection of items using a date field and a range of dates. 

























Field Summa 
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Fields inherited from class com.conceptis.cms.filter JtemDateRangeFilter 

DEFAULT PATTERN 
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Constructor Summary 

ItemFieldDateRang Filter ( ) 



Method Summary 


j ava . lang . String 


getFieldName ( ) 

Provides the fieldName being used to filter the results. 


void 


setFieldName (j ava . lang . String fieldName) 
Sets the fieldName to use. 



Methods inherited from class com.conceptis.cms.filter. ItemDateRangeFilter 

getEndDate , getLocale , getPattern , getStartPate , parseLocale , setEndPate , 
setLocale, setPattern , setStartPate 



Methods inherited from class com.conceptis.util.filter.RangeFilter 

filter, get Comparator, getEnd, getstart, islnclusive, islnside, 
setComparator , setEnd, setlnclusive, setlnside, setStart 



Methods inherited from class com.conceptis.util.filter. AbstractFilter 



filter 



Methods inherited from class java.lang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



IConstructor Detail 



1 .2.5.1 ItemFieldDateRangeFilter 
public ItemFieldDateRangeFilter ( ) 



Method Detail 
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1.2.5.2 getFieldName 

public java . lang . String getFieldName ( ) 

Provides the fieldName being used to filter the results. 
Returns: 

the fieldName being used to filter the results 



1 .2.5.3 setFieldName 

public void setFieldName (java . lang. String fieldName) 
Sets the fieldName to use. 
Parameters: 

fieldName - the fieldName to use 
1 .2.6 Class ItemFieldRegexFilter 

j ava . lang . Ob j ec t 

i 

+--com. conceptis .util . filter . AbstractFilter 

I 

+ - - com. concept is . cms . filter . ItemFieldRegexFilter 
All Implemented Interfaces: 

com.conceptis.util.filter.Filter 



public class ItemFieldRegexFilter 

extends com.conceptis.util.filter.AbstractFilter 

Filters a collection of items using a field of the item, and matching it with a regular 
expression. 



Field Summary 


private java . lang . String 


fieldName 

The field name used for filtering. 


private 

static org . apache . log4 j . Logger 


log 

For logging purposes. 


private 

j ava . util . regex . Pattern 


pattern 

The Pattern used for filtering. 


private java . lang . String 


regexp 

The regular expression used for filtering. 



Constructor Summary 

ItemFieldRegexFilter ( ) 
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Method Summary 


boolean 


f liter (j ava . lang. Object ob j ) 

Indicates whether an upject passes inis niier. 


j ava . lang . String 


getFieldName ( ) 

Provides the name of the field being filtered on. 


j ava . lang . String 


getRegexp ( ) 

Provides the regular expression used for filtering. 


void 


setPieldName ( j ava . lang . String f ieldName) 
Sets the name of the field being filtered on. 


void 


setRegexp ( j ava . lang . String regexp) 

Sets the regular expression used for filtering. 



Methods inherited from class com.conceptis.util.filter.AbstractFilter 




[filter 



(Methods inherited from class java.lang.Object 

(clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
I wait , wait, wait 



• 

Field Detail 




lllSIl 


J 


1.2.6.1 log 








private static org . apache . log4j . Logger log 








For logging purposes. 









1.2.6.2 fieldName 

private j ava . lang . String fieldName 
The field name used for filtering. 



1.2.6.3 regexp 

private j ava . lang . String regexp 

The regular expression used for filtering. 



1.2.6.4 pattern 

private j ava .util . regex. Pattern pattern 
The Pattern used for filtering. 
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Constructor Detail 

1 .2.7 ItemFieldRegexFilter 

public ItemFieldRegexFilter ( ) _____ 

Method 

1.2.7.1 filter 

public boolean f ilter (java . lang. Object ob j ) 
Indicates whether an Object passes this filter. 

T» 

jl «ti ttiiicici a. 

ob j - the object to pass through the filter. 
Returns: 

true if the object passes, false otherwise 



1 .2.7.2 getFieldName 

public java. lang. String getFieldName ( ) 

Provides the name of the field being filtered on. 
Returns: 

the name of the field being filtered on 



1.2.7.3 setFieldName 

public void setFieldName (java . lang . String fieldName) 
Sets the name of the field being filtered on. 
Parameters: 

fieldName - the name of the field to filter on 



1.2.7.4 getRegexp 

public java. lang. String getRegexp ( ) 

Provides the regular expression used for filtering. 
Returns: 

the regular expression used for filtering 



1 .2.7.5 setRegexp 

public void setRegexp (java . lang . String regexp) 

throws java .util . regex . PatternSyntaxException 

Sets the regular expression used for filtering. 

Parameters: 

regexp - the regular expression used for filtering 
Throws: 

j ava . ut il . regex . PatternSyntaxException - if the regular expression could not be 
compiled 
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1 .2.8 Class ItemItemTypeFilter 

j ava . lang . Ob j ec t 

i 

+- -com. concept is .util . filter .Abstract Filter 

I 

+- -com. concept is .cms . filter . ItemItemTypeFilter 
All Implemented Interfaces: 

com.conceptis.util.filter.Filter 



1 0 public class ItemItemTypeFilter 

extends com.conceptis.util. filter. AbstractFilter 

Filters a Collection of items using the itemType. 



Field Summary 


private boolean 


included 

Whether to include or exclude items of the type. 


private 

static org. apache . log4j . Logger 


log 

For logging purposes. 


private j ava . lang . String 


type 

The name of the itemType to filter on. 





: 0 MiP^., 








ItemItemTypeFilter ( ) 









15 

Method Summary 

boolean filter (j ava . lang. Object ob j ) 

Indicates whether an Object passes this filter, 
j ava . lang. String getltemType () 

Provides the itemType that is being used by the filter, 
boolean islncluded () 

Indicates whether the filter will include or exclude items of the 
specified type. 

void setlncluded (boolean included) 

Sets whether the filter will include or exclude items of the 
specified type. 



void 



se tl temType ( j ava . lang . String type) 

Sets the itemType to be used by the filter. 
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Methods inherited fr om class com.conceptis.util.filter.AbstractFilter 

filter 



Methods inherited from class java.lang.Object _ 

^loiie, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 



Field Detail 

T - „ _ _ 



1.2.8.1 log 

private static org. apache . log4j . Logger log 
For logging purposes. 



1.2.8.2 type 

private java . lang . String type 

The name of the itemType to filter on. 



1.2.8.3 included 




private boolean included 




Whether to include or exclude items of the type. 




Constructor Detail 




1 .2.8.4 ItemltemTypeFilter 




public ItemltemTypeFilter () 




Method Detail 



1.2.8.5 getltemType 

public java. lang. String getltemType ( ) 

Provides the itemType that is being used by the filter. 
Returns: 

the item type being used by the filter 



1.2.8.6 setltemType 

public void setltemType (java . lang. String type) 
Sets the ItemType to be used by the filter. 
Parameters: 

type - the item type to be used by the filter 
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1.2.8.7 islncluded 

public boolean islncluded ( ) 

Indicates whether the filter will include or exclude items of the specified type. 
5 Returns: 

true if items will be included, false otherwise 



1.2.8.8 setlncluded 

public void setlncluded {boolean included) 
1 0 Sets whether the filter will include or exclude items of the specified type. Defaults to 

true. 

Parameters: 

included - true if the items will be included, false otherwise 



1 5 1 .2.8.9 filter 

public boolean filter ( java . lang. Object ob j ) 
Indicates whether an Object passes this filter. 
Parameters: 

ob j - the object to pass through the filter. 
20 Returns: 

true if the object passes, false otherwise 

1 .2.9 Class ItemLastModificationDateComparator 

j ava . lang . Ob j ect 

25 | 

+ - - com. conceptis . cms . filter . ItemLastModif icationDateComparator 
All Implemented Interfaces: 

j a va. util . Comparator 



30 public class ItemLastModificationDateComparator 

extends java.lang.Object 
implements java.util.Comparator 

Comparator that is able to compare an item's last modification date to a Date. 



Field Summary 




j private 
[static org.apache.log4 j .Logger 


log 

For logging purposes. 



35 



Constructor Summary 

ItemLastModif icationDateComparator ( ) 
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Method Summary 


int 


compare (java.lang. Object ol, java . lang . Object o2) 
Compares two objects, which maybe items or Dates. 



Methods inherited from class java.lang.Object ^ 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



I Methods inherited from interface java.util.Comparator 

equals 



Field Detail 




1.2.9.1 log 

private static org. apache . log4j . Logger log 
For logging purposes. 


Construe 

.......... . . . . 


tor Detail 


1 .2.9.2 ItemLastModificationDateComparator 
public ItemLastModif icationDateComparator ( ) 

Method Detail 





10 1.2.9.3 compare 

public int compare (java.lang.Object ol, 

java.lang.Object o2) 
t hr ow s j a va .lang.ClassCastException 

Compares two objects, which may be items or Dates. 
1 5 Specified by: 

compare in interface java . util . Comparator 
Parameters: 

01 - the first object to compare 

02 - the second object to compare 
20 Returns: 
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a negative integer, zero, or a positive integer as the first argument is less than, equal to, 

or greater than the second 

Throws: 

java . lang . ciassCastException - if the arguments* types prevent them from being 
5 compared by this Comparator 

1.2.10 Class ItemLastModificationDateFilter 

j ava . lang . Ob j ect 

1 

10 +--com. conceptis . util . filter . AbstractFilter 

! 

+ - -com. concept is . util . filter . RangeFil ter 

i 

+ - - com . co nceptis . cms . filter , ItemDateRangeFilter 

15 I 

+ 

com . conceptis - cms . filter . ItemLastModificationDateFilter 
All Implemented Interfaces: 

com.conceptis.util.filter.Filter 

20 ______ 

public class ItemLastModificationDateFilter 

extends ItemDateRangeFilter 

Filters a collection of items using the last modified date and a range of dates. 



Field Summary 




private 

static java .util . Comparator 


comparator 

The comparator to use. 



25 



[Fields inherited from class com,conceptis.cms.filter,ItemDateRangeFilter 

1 DEFAULT PATTERN 



Fields inherited from class com.conceptis.util.filter.RangeFilter 



Constructor Summary 

ItemLastModificationDateFilter () 
Creates a new filter. 
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I Methods inherited from class com.concep tis.cms.filter.ItemDateRangeFilter 

[ getEndDate , getLocale , getPattern , getStartPate , parseLocale , setEndDate, 
IsetLocale, setPattern , setStartDate 



Methods inherited from class com.conceptis.util.filter.RangeFilter 



filter, get Comparator, get End, get Start , is Inclusive,- islnside, 
set Comparator, setEnd, setlnclusive, setlnside, setStart 



Methods inherited from class com.conceptis.utiLfilter.AbstractFilter 



Ifilter 



Methods inherited from class java.lang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Field Detatt 



1.2.10.1 comparator 

private static java .util . Comparator comparator 



The comparator to use. 



t — — — » - — - _ - ~~~~ — 

Con struct or Detail 

1 .2.10.2 ItemLastModificationDateFilter 
public ItemLastModificationDateFilter ( ) 
Creates a new filter. 

1.2.11 Class ItemLastModificationUserFilter 

j ava . lang . Ob j ect 

i 

+- -com. concept is .util . filter .Abstract Filter 

+ - - com. concept is - cms . filter . ItemLas tModif icationUserPilter 
All Implemented Interfaces: 

com.conceptis.util.filter.Filter 
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public class ItemLastModificationUserFilter 

extends com.conceptis.util.filter.AbstractFilter 

Filters a Collection of items using the last user to modify (username). 



Field Summary 


private boolean 


included 

Whether to include or exclude items of the type. 


private 

static org . apache . log4 j . Logger 


log 

For logging purposes. 


private j ava . lang . String 


username 

The username of the user to filter on. 



5 

Constructor Summarv 

_ 

ItemLastModificationUserFilter ( ) 



1VI h d S 
IVIcthod Sum 




boolean 


filter (java . lang. Object ob j ) 

Indicates whether an Object passes this filter. 


java . lang . String 


get User name ( ) 

Provides the username that is being used by the filter. 


boolean 


is Included ( ) 

Indicates whether the filter will include or exclude items of the 
specified type. 


void 


setlncluded (boolean included) 

Sets whether the filter will include or exclude items of the 
specified type. 


void 


setUsername ( j ava . lang . String username) 
Sets the username to be used by the filter. 



{Methods inherited from class com. conceptis.util.fi! ter.AbstractFilter 



filter 
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Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Field Detail 



1.2.11.1 log 

pxTiVatc StdtlC OITy . apache . 10y4 j . LOyycST lOy 

For logging purposes. 



1.2.11.2 username 

private java . lang . String username 

The username of the user to filter on. 



1.2.11.3 included 




private boolean included 




Whether to include or exclude items of the type. 




Constructor Detail 




1 .2.1 1 .4 ItemLastModificationUserFilter 




public ItemLastModificationUserFilter ( ) 




^^^^^^ ™~ ^"^^^ 




it 1 j ■ : z i if! 



15 1.2.11.5 getUsername 

public java . lang. String getUsername ( ) 

Provides the username that is being used by the filter. 
Returns: 

the username being used by the filter 
20 

1 .2.1 1 .6 setUsername 

public void setUsername ( java . lang. String username) 
Sets the username to be used by the filter. 
Parameters: 

25 username - the username to be used by the filter 



1.2.11.7 islncluded 

public boolean islncluded () 

Indicates whether the filter will include or exclude items of the specified type. 
30 Returns: 

true if items will be included, false otherwise 



163 



1.2.11.8 setlncluded 

public void setlnclud d (boolean included) 

Sets whether the filter will include or exclude items of the specified type. 
Parameters: 

5 included - true if the items will be included, false otherwise 



1.2.11.9 filter 

public boolean f liter (java . lang. Object ob j ) 
Indicates whether an Object passes this filter. 
1 0 Parameters: 

ob j - the object to pass through the filter. 
Returns: 

true if the object passes, false otherwise 
15 1.2.12 Class ItemNameComparator 

j ava . lang . Ob j ect 

i 

+- -com. concept is .cms . filter . ItemNameComparator 
All Implemented Interfaces: 

20 java.util.Comparator 



public class ItemNameComparator 

extends java.lang.Object 
implements java.util.Comparator 

25 Comparator that is able to compare an item f s names. 



Field S u m m 11 ry 


private 

static org. apache . log4j . Logger 


log 

For logging purposes. 


private boolean 


reverse 

Reverses the order. 



Constructor Summary 




ItemNameComparator ( } 




Creates a comparator. 




ItemNameComparator (boolean reverse) 




Creates a comparator. 
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Method Summary 


int 

■ 

! 


compare (java. lang. Obj ect ol, java . lang . Obj ect o2) 
Compares two objects, which maybe items or Dates. 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Methods inherited from interface java.util.Comparator 

equals 



Field Detail 



1.2.12.1 log 

private static org . apache . log4j . Logger log 
For logging purposes. 



1.2.12.2 reverse 
private boolean reverse 
Reverses the order. 



Constructor Detail _____ 



1 .2.12.3 ItemNameComparator 
public ItemNameComparator ( } 
Creates a comparator. 



1 .2.12.4 ItemNameComparator 

public ItemNameComparator (boolean reverse) 

Creates a comparator. 
Parameters: 

reverse - true if the order is to be reversed 

{Method Detail 



1.2.12.5 compare 

public int compare (java . lang . Obj ect ol, 

java.lang.Object o2) 
throws java . lang . ClassCastException 
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Compares two objects, which may be items or Dates. 
Specified by: 

compare in interface java . util . Comparator 
Parameters: 
5 oi - the first object to compare 

02 - the second object to compare 
Returns: 

a negative integer, zero, or a positive integer as the first argument is less than, equal to, 
or greater than the second 
1 0 Throws: 

if the arguments* types prevent them from being 

compared by this Comparator 
1.2.13 Class ItemPublicationStatusFilter 

15 java . lang . Object 

i 

+- -com. concept is .util . filter . AbstractFilter 

+ - - com, conceptis • cms . filter • ItemPublicationStatusFilter 
20 All Implemented Interfaces: 

com.conceptis.util.filter.Filter 

public class ItemPublicationStatusFilter 

extends com.conceptis.util.filter.AbstractFilter 

25 Filters a Collection of Items using the Publicat ionStatus. 



Field Summary 




private boolean 


included 

Whether to include or exclude items of the type. 


private 

static org. apache. log4j .Logger 


log 

For logging purposes. 


private j ava . lang . String 


status 

The name of the Pubiicationstatus to filter on. 



Constructor Summary 


- .... ' . ..' y ' ~ 


I ItemPublicationStatusFilter ( ) 







| Method Summary 
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boolean 


f liter (j ava . lang. Object obj) 

Indicates whether an Object passes this filter. 


j ava . lang . String 


getPublicationStatus () 

Provides the Pubiicationstatus that is being used by the filter. 


boolean 


islncluded ( ) 

Indicates whether the filter will include or exclude items of the 
specified type. 


void 


setlncluded (boolean included) 

Sets whether the filter will include or exclude items of the 
specified type. 


void 


setPublicat ionS tatus { j ava . lang . String status ) 

Sets the pubiicationstatus to be used by the filter. 



Methods inherited from class com. conceptis.util. filter. AbstractFilter 

filter 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 





i 


Field Detail 


1.2.13.1 log 




private static org. apache . log4j . Logger log 




For logging purposes. 





1.2.13.2 status 

private j ava . lang . String status 
1 0 The name of the pubiicationstatus to filter on. 



1.2.13.3 included 

private boolean included 

Whether to include or exclude ite ms of the typ e. 

Constructor Detail 



15 1.2.1 3.4 ItemPublicationStatusFilter 

public ItemPublicationStatusFilter ( } 
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Method Detail 



1.2.13.5 getPublicationStatus 

public java.lang. String getPublicationStatus ( ) 

Provides the Publicationstatus that is being used by the filter. 
Returns: 

the status being used by the filter 



1 .2.13.6 setPublicationStatus 

public void setPublicationStatus (java . lang. string status) 
Sets the Publicationstatus to be used by the filter. 
Parameters: 

status - the item status to be used by the filter 



1.2.13.7 islncluded 

public boolean islncluded () 

Indicates whether the filter will include or exclude items of the specified type. 

Returns: 

true if items will be included, false otherwise 



1.2.13.8 setlncluded 

public void setlncluded (boolean included) 

Sets whether the filter will include or exclude items of the specified type. 
Parameters: 

included - true if the items will be included, false otherwise 



1.2.13.9 filter 

public boolean filter (java. lang. Object ob j ) 
Indicates whether an Object passes this filter. 
Parameters: 

ob j - the object to pass through the filter. 
Returns: 

true if the object passes, false otherwise 
1 .2.1 4 Class ObjectWithPrimaryKeyComparator 

j ava . lang . Ob j ec t 

i 

+ - -com. concept is . cms . filter . Ob j ectWithPrimaryKeyComparator 
All Implemented Interfaces: 

java.util.Comparator 



public class ObjectWithPrimaryKeyComparator 

extends java.lang.Object 
implements java.util.Comparator 
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Comparator that utilizes an object's PrimaryKey to sort a collection. 



Field Summary 


private boolean 


ascending 

Whether to sort ascending or descending. 


private 

static org . apache . log4 j . Logger 


log 

For logging purposes. 



{Constructor Summary 

| Ob j ectWithPrimaryKeyComparator ( ) 



Method Summary" 


int 


compare (java . lang. Object ol, java . lang . Object o2) 
Compares its two arguments for order. 


boolean 


isAscending ( ) 

Indicates whether the comparator is sorting in an ascending or descending 
manner. 


void 


setAscending (boolean ascending) 

Sets whether the comparator is sorting in an ascending or descending manner. 



5 



Methods inherited from class jaya.lang.Object 

[clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
| wait, wait, wait 



Methods inherited from interface java.utiLComparator 

equals 



Field Detail 
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1.2.14.1 log 

private static org . apache . log4j . Logger log 
For logging purposes. 



5 1.2.14.2 ascending 

private boolean ascending 

Whether to sort ascending or descending. 

Constructor Detail 



1 .^.14.3 ObjectWithrrimaryKeyComparaior 

public ObjectWithPrimaryKeyComparator ( ) 

Method Detail , ; _ . 

10 1.2.14.4 isAscending 

public boolean isAscending ( ) 

Indicates whether the comparator is sorting in an ascending or descending manner. 
Returns: 

true if the comparator is ascending, false if descending 
15 __ 

1 .2.14.5 setAscending 

public void setAscending (boolean ascending) 

Sets whether the comparator is sorting in an ascending or descending manner. 
Parameters: 

20 ascending - true if the comparator is ascending, false otherwise 



1.2.14.6 compare 

public int compare (java . lang . Ob j ect ol, 

java. lang. Object o2) 
25 throws java . lang . ClassCastException 

Compares its two arguments for order. Returns a negative integer, zero, or a positive 
integer as the first argument is less than, equal to, or greater than the second. 
Specified by: 

compare in interface j ava . ut il . Comparator 
30 Parameters: 

01 - the first object to be compared 

02 - the second object to be compared 
Returns: 

a negative integer, zero, or a positive integer as the first argument is less than, equal to, 
35 or greater than the second 

Throws: 

j ava . lang . ClassCastException - if the arguments' types prevent them from being 
compared by this Comparator 
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1.3 PACKAGE COM.CONCEPTIS.CMS.UTIL 
1.3.1 Class CmsManagerFactory 

j ava . 1 ang . ob j ec t 

I 

+ - - com . concept is . cms • util . CmsManagerFactory 



public class CmsManagerFactory 




extends java.lang.Object 




This class is used to get a cmsManager 




See Also: 




Cms Server 




Constructor Summary 

* / . 


\ 


CmsManagerFactory ( ) 1 



Method Summary 




1 CmsManager 

1 


getCmsManager ( ) 

get a CmsManager 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Constructor Detail 


• ./> . . • ..- x 


1 .3.1 .1 CmsManagerFactory 
public CmsManagerFactory ( ) 


Method Detail 




■ 


1 .3.1 .2 getCmsManager 




public CmsManager getCmsManager ( ) 




get a CmsManager 




Returns: 




CmsManager 
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1 .3.2 Class CmsServer 

java. lang. Object 

i 

+ - -com. conceptis .cms . u til . CmsServer 

Direct Known Subclasses: 

PoolingCmsServer . PseudoPoolingCmsServer 



public class CmsServer 
extends java.lang.Object 

A CmsServer represents a CMS server and provides a useful single point of entry to get and 
return Connections. 



Field Summary 


private Driver 


driver 

The Driver to use for this CmsServer. 


private j ava . lang . String 


id 

The unique ID of this CmsServer 


private 

static org . apache . log4 j . Logger 


log 

the log 


private java .util . Properties 


properties 

Configuration options for the Connections 


private j ava . ut il . HashMap 


roleMapping 

A HashMap of roles (string key) associated with a 
username/password pair (value stored in another 
HashMap, with 'username' and 'password' keys). 


private j ava . lang . String 


url 

The URL that will be used to get a Connection to 

the CmsServer. 



Constructor Summary 

j CmsServer ( j ava . lang . String id, java . lang . String driverClassName, 
java. lang. String url, java .util . HashMap roleMapping, 
java .util . Properties properties) 

Creates a new CmsServer that will create connections using the given URL and 
properties. 



Method Summary 

(package private) j getConnection (java . lang. String role) 
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Connection 


Returns a connection to this CmsServer, using the specified 
driver, url and properties. 


Driver 


getDriver ( ) 

Returns the Driver used by this CmsServer to establish 
Connection to the CMS. 


j ava . lang . String 


getldO 

Returns the unique ID associated to this CmsServer. 


java .util . Properties 


getProperties () 

Return the Properties used by this CmsServer to establish 
Connections to the CMS. 


java . util . Properties 


getProperties (java . lang. String role) 

Return the Properties used by this CmsServer to establish 
Connections to the CMS and using the specified role. 


java .util .HashMap 


getRoleMapping ( ) 

Returns the HashMap of roles (string key) associated with a 
username/password pair (value stored in a Properties class, with 
'username 1 and 'pas sword' keys). 


j ava . lang . String 


geturl () 

Returns the URL used by this CmsServer to establish 
Connection to the CMS. 


{package private) 
void 


returnConnection (Connection connection) 


Returns the given Connection to this CmsServer, that will 
dispose of it. 


java . lang. String! 


toString () 

Returns a string representation of this CmsServer. 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 



Field Detail 

1.3.2.1 log 

private static org. apache . log4j . Logger log 
5 the log 



1.3.2.2 id 

private java . lang . String id 

The unique ID of this CmsServer 
10 
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1.3.2.3 driver 

private Driver driver 

The Driver to use for this Cmsserver. 



1.3.2.4 uri 

private java . lang . String url 

The URL that will be used to get a connection to the cmsserver. 



1.3.2.5 roieMapping 

private j ava . util . HashMap roleaappincf 

A HashMap of roles (string key) associated with a username/password pair (value 
stored in another HashMap, with 'usemame' and 'password' keys). 



1.3.2.6 properties 




private java . util . Properties properties 




Configuration options for the connections 




Constructor Detail 


- 




1.3.2.7 CmsServer 




public CmsServer (java . lang . String id, 





j ava . lang . String driverClassName , 
java . lang. String url # 
java .util .HashMap roieMapping, 
java . util . Properties properties) 
throws java. lang . IllegalArgumentExcept ion 



Creates a new CmsServer that will create connections using the given URL and 
properties. 
Parameters: 

id - the unique ID of this CmsServer 

driverClassName - the fully qualifed name of the Driver 

uri - the url to open a connection to 

roieMapping - a HashMap of roles (string key) associated with a username/password 
pair (value stored in a Properties class) 
properties - configuration options for the desired connection 
Throws: 

java . lang . IllegalArgumentExcept ion - if one of the parameters is not valid 

Method Detail " V v ^ ■ ■ y- : - ; , ■ 

1 .3.2.8 getConnection 

Connection getConnection (java . lang . String role) 

throws Connect ionExcept ion , 

AuthenticationException , 
Author izat ionExcept ion 
Returns a connection to this cmsserver, using the specified driver, url and properties. 
Parameters: 

role - the user role to create the Connection for 
Returns: 
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a Connection to this CmsServer. 
Throws: 

Connect ionExcept ion - thrown if there is a problem 

AuthenticationException - thrown if the username/password combination is invalid 
5 Authorizat ionExcept ion - if the site is inaccessible 



1 .3.2.9 returnConnection 

void returnConnection ( Connection connection) 

Returns the given connection to this CmsServer, that will dispose of it. The default 
1 0 implementation juste closes the connection, logging any Exception that may occur 

during this operation. 
Parameters: 

connection - the Connection to return to this CmsServer 



15 1.3.2.10 getld 

public java . lang. String getld () 

Returns the unique ID associated to this CmsServer. 
Returns: 

the unique ID associated to this cms server 
20 

1.3.2.11 getDriver 

public Driver getDriver ( ) 

Returns the Driver used by this CmsServer to establish Connection to the CMS. 

Returns: 

25 the Driver used by this CmsServer 



1.3.2.12 getUrl 

public java . lang. String getUrlO 

Returns the URL used by this CmsServer to establish Connection to the CMS. 
30 Returns: 

the URL used by this CmsServer 



1.3.2.13 getRoleMapping 

public java . util . HashMap getRoleMapping ( ) 
35 Returns the HashMap of roles (string key) associated with a username/password pair 

(value Stored in a Properties class, with 'username 1 and 'password' keys). 
Returns: 

the HashMap of roles 



40 1.3.2.14 getProperties 

public java .util . Properties getProperties ( ) 

Return the Properties used by this CmsServer to establish Connections to the CMS. 
Returns: 

the Properties used by this CmsServer 



175 



1.3.2.15 getProperties 

public java.util . Properties getProperties (j ava . lang . String role) 

throws java . lang. II legal Argument Except ion 
Return the Properties used by this Cmsserver to establish Connections to the CMS 
and using the specified role. 
Parameters: 

role - the role for which the returned Properties are designed for 
Returns: 

the Properties used by this CmsServer and using the specified role 
Throws: 

java. lang. II legal Argument Except ion - if the specified role is not supported 



1.3.2.16 toString 

public java . lang. String toString () 

Returns a string representation of this cmsserver. 
Overrides: 

toString in class java . lang. Object 
Returns: 

a string representation of this cmsserver 
1 .3.3 Class Connection Pool 

j ava . lang . Ob j ec t 

i 

+ --com. codes tudio .util .Obj ectPool 

i 

+- -com. concept is .cms .util. ConnectionPool 
AH Implemented Interfaces: 

com.codestudio.util.Pool, java.io.Serializable 



public class ConnectionPool 

extends com.codestudio.util.ObjectPool 



A ConnectionPool is used by a PoolingCmsServer to pool Connections to a CMS. 

See Also: 

Serialized Form 



i ~~ ~~ : - „ - , ~~ 

field Summary 


private Driver 


driver 

The Driver to use to establish a connection 


private 

static org . apache . log4 j . Logger 


log 

the log 


private java . util . Properties 


properties 

the Properties to use to establish a Connection 


private j ava . lang . String 


url 
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the url to use to establish a connection 



Fields inherited from class com.codestudio.util.ObjectPool 

count, lifeguard, locked, logger, metadata, skimmer, unlocked 



Constructor Summary — 

ConnectionPool ( Driver driver, java . lang. String url, 

java . util . Properties properties, 

com . codestudio . util . PoolMetaData poolMetaData) 

Creates a new cmsserver that will create connections using the given URL and 
properties. 



Method Summary 


protected 
java . lang. Object 


create ( ) 

Creates a new connection instance 


protected void 


expire (java . lang. Object ob j ) 
Closes the Connection. 


private void 


setD river (Driver driver) 

Sets the Driver to use to establish a Connection 


private void 


setProperties (java .util . Properties DroDerties) 

Sets the Properties to use to establish a Connection 


private void 


setUrl (java . lang. Strinq url) 

Sets the url to use to establish a connection 


java . lang. String 


toString ( ) 

Returns a string representation of this connect ionPool, which is 
mainly useful for debugging. 


protected 
boolean 


validate (java. lanq. Object ob j ) 
Validates a connection. 



Methods inherited from class com.codestudio.util.ObjectPool 

checkln, checkout, checkTimeout , cleanup, closeAHResources , debug, debug, 
debugMetrics, finalize, getPoolname, init, log, log, numCheckedlnObjects , 
numCheckedOutOb j ect s , numTotalOb j ect s , requestOb j ect , returnOb j ect 
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Methods inherited from class java.lang.Object 


clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait 




Field Detail 


1.3.3.1 log 




private static org. apache . log4j . Logger log 




*U,> 1 — 
HIV iug 




1 .3.3.2 driver 




private Driver driver 




The Driver to use to establish a Connection 




1.3.3.3 url 




private java . lang . String url 




the url to use to establish a connection 





1 .3.3.4 properties 

private java . util . Properties properties 

th e Properties to use to establish a Connection 

Constructor Detail 

1 .3.3.5 ConnectionPool 

public ConnectionPool ( Driver driver, 

java. lang. String url, 
java. util . Properties properties, 
com. codestudio.util . PoolMetaData poolMetaData) 
throws java . lang. Exception 
Creates a new cmsserver that will create connections using the given URL and 
properties. 
Parameters: 

driver - the Driver to use to establich a Connection 
url - the url to open a connection to 

properties - configuration options for the desired connection 
poolMetaData - specific pooling configuration, encapsulated in a PoolMetaData 
object 
Throws: 

java . lang . Exception - if an error occurs while initalizong this poo l 

Method Detail ~~~~ ~W 



1 .3.3.6 create 

protected java.lang.Object create () 
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throws java . lang. Exception 
Creates a new connection instance 
Specified by: 

create in class com.codestudio.util .ObjectPool 
Returns: 

a new Connection 
Throws: 

java . lang . Exception - if the Connection creation encounters a problem 



1.3.3.7 expire 

protected void expire ( java . lang . obj ect ob j ) 
Closes the Connection. 
Overrides: 

expire in class com. codestudio . ut il . Ob j ectPool 
Parameters: 

ob j - the pooled object to kill 



1.3.3.8 validate 

protected boolean validate (java . lang . Object ob j ) 
Validates a connection. 
Specified by: 

validate in class com. codestudio .util . ObjectPool 
Parameters: 

obj - the Connection to validate 
Returns: 

true if the Connection is valid; false otherwise 



1.3.3.9 setDriver 

private void setDriver ( Driver driver) 

Sets the Driver to use to establish a Connection 
Parameters: 

driver - the Driver to use to establish a Connection 



1.3.3.10 setUrl 

private void setUrl (java . lang. String url) 
Sets the url to use to establish a connection 
Parameters: 

url - the url to use to establish a connection 



1.3.3.11 setProperties 

private void setProperties (java . util . Properties properties) 
Sets the Properties to use to establish a Connection 
Parameters: 

properties - the Properties to use to establish a Connection 
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1.3.3.12 toString 

public java . lang. String toString () 

Returns a string representation of this ConnectionPool, which is mainly useful for 
debugging. 
5 Overrides: 

toString in class j ava . lang . Ob j ect 
Returns: 

a string representation of this ConnectionPool 
1 0 1 .3.4 Class DefaultCmsManagerImpl 

-i -IfT-S 1 -.•VIS* /^kV»-i 
JUVU . JL. Uii^ . WiJ J 

I 

+- -com. concept is .cms .util .DefaultCmsManagerImpl 
All Implemented Interfaces: 

15 CmsManager 



public class DefaultCmsManagerImpl 

extends java.lang.Object 
implements CmsManager 

20 This class is a default CmsManager implementation. TODO: DESCRIBE ROUTING LOGIC 
HERE (WHEN IT'S IMPLEMENTED) 



Field Summary 


private java . util . HashMap 


cmsServers 

This HashMap contains all the CMS servers 
defined in the configuration file. 


private java . util . HashMap 


connections 

A HashMap of Connections and CmsServers, used 
to link a returned connection to its originating 
CmsServer. 


private CmsServer 


default Cms Server 

The default CmsServer 


private java . util . HashMap 


itemTypeHandlers 

The associations between itemTypes and a 
specific CmsServer: the key is the itemType name, and 
the value is the CmsServer that will handle it. 


private 

static org. apache . log4j . Logger 


log 

the log 



Constructor Summary 

DefaultCmsManagerImpl ( ) 
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Method Summary 


void 


addCmsServer (CmsServer cmsServer) 

Adds a CmsServer to the list of available servers. 


private 
void 


addltemTypeHandler (java. lang. String itemTypeName, 
CmsServer cmsServer) 

Adds a itemType to the routing logic, associated with the specified 

CmsServer. 


VOld 


«*«*WL**W Wt. W^U*J A ^- W^/Vil. V t.lllOUCi. V ^ J. ^IllOUCi. V W J- / 


java. lang. String propertyName, j ava . lang . String proper tyValue) 

Adds a routing property to this cmsManager for the specified CmsServer. 


CmsServer 


get Cms Server (java . lang. String id) 

Returns the CmsServer that has the specified ID. 


private 
Connection 


getConnection (CmsServer cmsServer, java . lang . String role) 
get a Connection with role 


Connection 


getConnection (java. lang. String role) 
get a Connection with role 


Connection 


getConnection ( j ava . lang. String role, 
java . lang. String itemTypeName) 

get a connection with role and typeName 


void 


releaseConnection (Connection conn) 


release the Connection to the Connection Pool. 


private 
void 


setDe fault Cms Server (CmsServer def aultCmsServer) 


Sets the default CmsServer bor this CmsManager. 





Methods inherited from class java.Iang.Object 



clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



Field Detail 

i •:•■!: ■ . Z ,. . .. L^M^i, : „„._„_: 

1.3.4.1 log 

private static org. apache . log4j . Logger log 
the log 



1 .3.5 cmsServers 

private java . util . HashMap cmsServers 

This HashMap contains all the CMS servers defined in the configuration file. The key is 
the unique ID associated to the CmsServer. 
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1.3.5.1 defaultCmsS rver 
private CmsServer def aultCmsServer 
The default CmsServer 



1 .3.5.2 connections 

private java . util . HashMap connections 

A HashMap of Connections and Cms Servers, used to link a returned Connection to its 
originating Cms Server. 



1 .3.5.3 iiemTyperiandiers 

private java . util . HashMap itemTypeHandlers 

The associations between itemTypes and a specific CmsServer: the key is the 
itemType name, and the value is the CmsServer that will handle it. 



Constructor Detail 




1 .3.5.4 DefaultCmsManagerlmpI 
public DefaultCmsManagerlmpI ( ) 


Method Detail 





1 .3.5.5 addCmsServer 

public void addCmsServer ( CmsServer cmsServer) 
Adds a CmsServer to the list of available servers. 
Specified by: 

addCmsServer in interface CmsManager 
Parameters: 

cmsServer - the CmsServer to add to the list of available CmsServers for this 
CmsManager 



1 .3.5.6 addRoutingProperty 

public void addRoutingProperty ( CmsServer cmsServer, 

java . lang. String propertyName , 
java . lang. String propertyValue) 

Adds a routing property to this CmsManager for the specified CmsServer. 
Specified by: 

addRout ingProperty in interface CmsManager 
Parameters: 

cmsServer - the CmsServer concerned by this routing rule 
propertyName - the name of the property 
propertyValue - the value of the property 



1 .3.5.7 setDefaultCmsServer 

private void setDefaultCmsServer ( CmsServer def aultCmsServer) 
Sets the default CmsServer bor this CmsManager. 
Parameters: 

def aultCmsServer - the default CmsServer for this CmsManager 
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1 .3.5.8 addltemTypeHandler 

private void addltemTypeHandler (java . lang. String itemTypeName, 

CmsServer cmsServer) 
5 Adds a itemType to the routing logic, associated with the specified CmsServer. 

Parameters: 

itemTypeName - the name the will be used to identify the itemType 
cmsServer - the CmsServer that will handle the specified ItemType identified by the 
itemTypeName parameter 
10 

1 .3.5.9 getCmsServer 

public CmsServer getCmsServer ( java . lang . String id) 
Returns the CmsServer that has the specified ID. 
Specified by: 
1 5 getCmsServer in interface CmsManager 

Parameters: 

id - ths unique ID of the CmsServer 
Returns: 

the CmsServer that has the specified ID; null if it doesn't exist 
20 __ 

1.3.5.10 getConnection 

private Connection getConnection ( CmsServer cmsServer, 

java . lang. String role) 
throws CmsException 
25 get a connection with role 

Parameters: 

cmsServer - the CmsServer to use 
role - the user role 
Returns: 
30 a Connection 

Throws: 

CmsException - in case of errors 



1 .3.5.1 1 getConnection 

35 public Connection getConnection (java . lang. String role) 

throws CmsException 
get a Connection with role 
Specified by: 

getConnection in interface CmsManager 
40 Parameters: 

role - the user role 
Returns: 
a Connection 
Throws: 

45 CmsException - in case of errors 
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1 .3.5.1 2 getConnection 

public Connection getConnection ( java . lang. String role, 

java . lang. String itemTypeName) 
throws CmsException 

5 get a connection with role and typeName 

Specified by: 

getConnection in interface CmsManager 

Parameters: 

role - the user role 
1 0 itemTypeName - the name of the item type 

Returns: 
a Connection 
Throws: 

CmsException - in case of errors 
15 

1 .3.5. 1 3 releaseConnection 

public void releaseConnection ( Connection conn) 

throws CmsException 
release the Connection to the Connection Pool. 
20 Specified by: 

releaseConnection in interface CmsManager 
Parameters: 

conn - the Connection to release 
Throws: 

25 CmsException - in case of errors 

1 .3.6 Class NodeData 

j ava . lang . Ob j ect 

i 

30 +- -com. concept is. cms .util. NodeData 

All Implemented Interfaces: 

j ava. io . Serializable 



public class NodeData 
35 extends java.lang.Object 

implements java.io.Serializable 

This class represents an item in the CMS as a serializable object. It is made to be extended, 
containing only the primary key of the node. 

See Also: 

40 Serialized Form 



Field Sum ma 






private 
j ava . lang . String 


id 

The primary key of the node. 
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Constructor Summary 

NodeData () 



Method Summary 


j ava . lang . String 


getld ( ) 


void 


setld (j ava . lang. String id) 
Sets the id of the node. 


j ava . lang . String 


toString ( ) 

Provides a string representation of the object. 



Methods inherited from class java.Iang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 



Field Detail 

• .:*::?:;• 



„ ■ * ^„______™ „ . ... . ; Q ; . 

1.3.6.1 id 
5 private j ava . lang . String id 

The primary key of th e node. 



Constructor Detail 



1 .3.6.2 NodeData 
public NodeData () 



Method Detail 

: • ■•:■-,-■:>:-:.,:■:■:: . . ....... 



1.3.6.3 getld 
10 public j ava . lang. String getld () 
Provides the id of the node. 
Returns: 
the id of the node 



15 1.3.6.4 setld 

public void setld (j ava . lang. String id) 
Sets the id of the node. 
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Parameters: 

id - the id of the node 



10 



1 .3.6.5 toString 

public java.lang. String toString () 

Provides a string representation of the object. 
Overrides: 

toString in class j ava . lang . Ob j ec t 
Returns: 

a string representation of the object 



15 



1 .3.7 Class NodeLoader 

j ava . lang . Ob j ec t 

i 

+- -com. conceptis .cms .u til. NodeLoader 



public abstract class NodeLoader 
extends java.lang.Object 

Generates a serializable representation of a node in the CMS. 
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Field Summary 


private org . apache . log4 j . Logger 


log 

Used to log. 


private 

j avax . swing . tree . Def aul tMut ableTreeNode 


root 

The root node where we append 
children. 



Constructor Summary 







NodeLoader ( j avax . swing . tree . Def aul tMutableTreeNode root ) 
Constructs a new NodeLoader. 



Method Summary 


void 


appendChildNode ( i avax . swina . tree . Def 


aultMutableTreeNode root) 

Append the child node to the parent 

(root). 


abstract NodeData 


generateNodeData (Item item, 




Connection conn) 
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Generates a NodeData object using 
the values of the specified item. 


abstract java . util . Set 


getChildren (Item item, 
Connection conn) 

Provides the Set of children for the 

node. 


j avax . swing . tree . Def aul tMutableTreeNod 

e 


getRoot ( ) 

Provides the root where we append 
children. 


abstract boolean 


isExpandable (Item parent, 
Item child, Connect ion conn) 

Indicates whether a given node is 
expandable. 


abstract boolean 


islnsertable (Item parent, 
Item child, Connection conn) 

Indicates whether a given node is 
insertable into the tree 

UlUVl Ull/lV ill LV/ 111 V UVVi 


void 


loadNode { ) 

load the node 


private void 


recurseChild (Item item, 

j avax . swing . tree . Def aul tMutableTreeN 

ode parent, Connection conn) 

recurse over child item and create a 
new node. 



Methods inherited from class java. lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, 
wait, wait, wait 



^ieldi>etail 



1.3.7.1 log 




private org . apache . log4 j . Logger log 




Used to log. 




1.3.7.2 root 




private j avax . swing. tree . Def aul tMutableTreeNode root 




The root node where we append children. 




Constructor Detail 
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1.3.7.3 NodeLoader 

public NodeLoader (javax. swing. tree. DefaultMutableTreeNode root) 

Constructs a new NodeLoader. 
Parameters: 

root - the root node to append to 

Method Detail < -J r 



1.3.7.4 getRoot 

public javax. swing. tree. DefaultMutableTreeNode getRoot () 
Provides the root where we append children. 
Returns: 

the root where we append children 



1 .3.7.5 generateNodeData 

public abstract NodeData generateNodeData ( Item item, 

Connection conn) 
Generates a NodeData object using the values of the specified item. 
Parameters: 

item - the item to generate a data object for 
conn - the connection, to interact with the CMS 
Returns: 

a data object for the specified item 



1.3.7.6 isExpandable 

public abstract boolean isExpandable ( Item parent, 

Item child, 
Connection conn) 

Indicates whether a given node is expandable. 

Parameters: 

parent - the parent item to determine whether it's node is insertable 
child - the child item to determine whether it's node is insertable 
conn - the connection, to interact with the CMS 
Returns: 

true if the node is expandable, false otherwise 



1.3.7.7 islnsertable 

public abstract boolean islnsertable ( Item parent, 

Item child, 
Connection conn) 

Indicates whether a given node is insertable into the tree. 

Parameters: 

parent - the parent item to determine whether it's node is insertable 
child - the child item to determine whether it's node is insertable 
conn - the connection, to interact with the CMS 
Returns: 

true if the node is insertable, false otherwise 
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1.3.7.8 getChildren 

public abstract java .util . Set getChildren (Item item, 

Connection conn) 

Provides the Set of children for the node. 
5 Parameters: 

item - the parent item 

conn - the connection, to interact with the CMS 

Returns: 

the set of children 



10 



20 



public void loadNodeO 
load the node 



15 1.3.7.10 appendChildNode 

public void appendChildNode (javax. swing. tree .DefaultMutableTreeNode root) 
Append the child node to the parent (root). 
Parameters: 
root - the node parent 



40 



1.3.7.11 recurseChild 

private void recurseChild (Item item, 

j avax . swing . tree . Def aul tMutableTreeNode parent , 
Connection conn) 
25 throws CmsException 

recurse over child item and create a new node. 
Parameters: 

item - the item to get child 
parent - the Node parent to append to 
30 conn - the Connection used to get the RelationTypeFactory 

Throws: 

CmsException - in case of errors 
1 .3.8 Class PoolingCmsServer 

35 java. lang. Object 

i 

+- - com, conceptis . cms .util . CmsServer 

i 

+ - - com . conceptis . cms . util . PoolingCmsServer 



public class PoolingCmsServer 

extends CmsServer 

A CmsServer represents a CMS server and provides a useful single point of entry to get and 
return Connections. 



45 
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Field Summary 


private java .util . HashMap 


connect ionPools 

A HashMap of Connect ionPools, one for each 

role. 


private java .util . HashMap 


connections 

A HashMap of Connect ionPool, associated 
with a Connection 


private 

static org . apache . log4 j . Logger 


log 

the log 


private 

com. code studio .util . PoolMetaData 


poolMetaData 

The PoolMetaData that will be used to create 
the connect ionPools for each role. 



Fields inherited from class com.conceptis.cms.util. CmsServer 



I Constructor Summary 



PoolingCmsServer ( j ava . lang . String id, j ava . lang . String driverClassName, 

java . lang. String url, java .util .HashMap roleMapping, 

java .util . Properties properties, 

com. code studio . util . PoolMetaData poolMetaData) 

Creates a new cmsserver that will create Connections using the given URL and 
properties. 



Method Summary 


Connection 


getConnection (java . lang. String role) 

Returns a Connection to this cmsserver, using the specified driver, url 
and properties. 


void 


re turnConnect ion (Connection connection) 


Returns the given Connection to this Cmsserver, that will dispose of it. 


private 
void 


setPoolMetaData (com. codestudio .util . PoolMetaData poolMetaData) 
Sets the PoolMetaData used by this PoolingCmsServer. 



{Methods inherited from class com.conceptis.cms.util. CmsServer 



getDriver , getld , getProperties , getProperties , ge t Ro 1 eMapp ing , getUrl , 
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toString 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, 
wait 



Field Detail 



1.3.8.1 log 

private static org. apache . log4j . Logger log 
5 the log 



1 .3.8.2 connectionPools 

private java . util . HashMap connectionPools 

A HashMap of ConnectionPools, one for each role. 



1.3.8.3 connections 

private java . util . HashMap connections 

A HashMap of Connect ion Pool, associated with a Connection 



1 5 1 .3.8.4 poolMetaData 

private com. codes tudio .util . PoolMetaData poolMetaData 

The PoolMetaData that will be used to create the ConnectionPools for each role. 



Constructor Detail 



\ 2 ; 

1 .3.8.5 PoolingCmsServer 

public PoolingCmsServer (java . lang. String id, 
20 j ava . lang . String driverClassName , 

java . lang. String url, 
java .util . HashMap roleMapping, 
java .util . Properties properties, 
com. codes tudio .util . PoolMetaData poolMetaData) 
25 throws java. lang. I 1 legal Argument Except ion 

Creates a new cmsserver that will create connections using the given URL and 
properties. 
Parameters: 

id - the unique ID of this Cmsserver 
30 driverClassName - the fully qualifed name of the Driver 

url - the url to open a connection to 

roleMapping - a HashMap of roles (string key) associated with a username/password 
pair (value stored in a Properties class) 
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properties - configuration options for the desired connection 
pooiMetaData - the PoolMetaData that will be used to create the internal 
Connect ionPool 
Throws: 

5 java . lang. illegal Argument Except ion - if one of the parameters is not valid 



Method Detail 



1 .3.8.6 getConnection 

public Connection getConnection (java . lang. String role) 

throws ConnectionException , 

Autlient icat icnSxcept ion , 
1 0 AuthorizationException 

Returns a Connection to this cmsserver, using the specified driver, url and properties. 

Overrides: 

getConnection in class Cms Server 
Parameters: 

1 5 role - the user role to create the connection for 

Returns: 

a Connection to this Cms Server. 
Throws: 

conne c t i onExc ep t i on - thrown if there is a problem 
20 AuthenticationException - thrown if the username/password combination is invalid 

AuthorizationException - if the site is inaccessible 

1 .3.8.7 returnConnection 

public void returnConnection ( Connection connection) 
25 Returns the given connection to this cmsserver, that will dispose of it. The default 

implementation juste closes the connection, logging any Exception that may occur 
during this operation. 
Overrides: 

returnConnection in class CmsServer 
30 Parameters: 

connection - the Connection to return to this CmsServer 

1 .3.8.8 setPoolMetaData 

private void setPoolMetaData (com. codes tudio .util . PoolMetaData pooiMetaData) 
35 Sets the PoolMetaData used by this PoolingCmsServer. 

Parameters: 

pooiMetaData - the PoolMetaData used by this PoolingCmsServer 
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1 .3.9 Class PseudoPoolingCmsServer 

j ava . lang . Ob j ec t 

i 

+--com. conceptis . cms . util . CmsServer 

5 I 

+- -com. conceptis .cms .util .PseudoPoolingCmsServer 

public class PseudoPoolingCmsServer 

extends CmsServer 

10 A PseudoPoolingCmsServer represents a CMS server that creates and return only a single 
connection for each username/ password combination, and returns the same one to multiple 
processes at the same time. 



Field Summary 


private j ava .util . HashMap 


connections 


A HashMap of Connections, one for each role. 


private 

static org . apache . log4 j . Logger 


log 

the log 



Fields inherited from class com.conceptis.cms.util. CmsServer 



Constructor Summary 




PseudoPoolingCmsServer ( j ava . lang . String id, 

j ava. lang. String driverClassName, j ava . lang . String url, 

j ava .util .HashMap roleMapping, j ava . util . Properties properties) 

Creates a new CmsServer that will create Connections using the given URL and 
properties. 



Method Summary 


Connection 


getConnection { j ava . lang . String role) 

Returns a Connection to this CmsServer, using the specified driver, url 
and properties. 


void 


returnConnection (Connection connection) 

Returns the given Connection to this CmsServer, that will dispose of it. 
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I Methods inherited from class com.conceptis.cms.util. CmsServer 

i — .- . — — — , .» — — 

j getDriver , getld , getPropert ies , getPropert ies , getRoleMapping , getUrl , 
| toString 



Methods inherited from class java.lang.Object 

clone, equals, finalize, getClass, hashCode.. notify. notifyAll. wait. wait, 
wait 



Field Detail 

1.3.9.1 log 

private static org . apache . log4j . Logger log 
the log 



1 .3.9.2 connections 

private java . util .HashMap connections 
10 A HashMap of Connections, one for each role. 



. 

1 .3.9.3 PseudoPoolingCmsServer 

public PseudoPoolingCmsServer (java . lang. String id, 

j ava . lang . String driverClassName, 
java . lang. String url, 
15 java .util .HashMap roleMapping, 

java .util . Properties properties) 
throws java. lang. Illegal Argument Except ion 

Creates a new CmsServer that will create connections using the given URL and 
properties. 
20 Parameters: 

id - the unique ID of this CmsServer 

driverClassName - the fully qualifed name of the Driver 
url - the url to open a connection to 

roleMapping - a HashMap of roles (string key) associated with a username/password 
25 pair (value stored in a Properties class) 

properties - configuration options for the desired connection 
Throws: 

java. lang. illegal Argument Except ion - if one of the parameters is not valid 



Method Detail 
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1 .3.9.4 getConnection 

public Connection getConnection (java . lang. String role) 

throws Conne c t i onExc ep t i on , 

AuthenticationException , 
AuthorizationException 
Returns a connection to this cmsserver, using the specified driver, url and properties. 
Overrides: 

getConnection in class CmsServer 
Parameters: 

role - the user role to create the Connection for 
Returns: 

a Connection to this CmsServer. 
Throws: 

ConnectionException - thrown if there is a problem 

AuthenticationException - thrown if the username/password combination is invalid 
AuthorizationException - if the site is inaccessible 



1 .3.9.5 return Connection 

public void returnConnection ( Connection connection) 

Returns the given connection to this CmsServer, that will dispose of it. The default 
implementation juste closes the Connection, logging any Exception that may occur 
during this operation. 
Overrides: 

returnConnection in class CmsServer 
Parameters: 

connection - the Connection to return to this CmsServer 

1 .3. 1 0 Interface CmsManager 
All Known Implementing Classes: 
DefaultCmsManagerlmpl 

public interface CmsManager 

This interface is used to get a connection to the cms. 

See Also: 

Connection 



Method Summary 


void 


addCmsServer (CmsServer CmsServer) 

Adds a CmsServer to the list of available servers. 


void 


addRoutingProperty (CmsServer CmsServer , 


java. lang. String propertyName, java . lang. string propertyValue) 
Adds a routing property to this CmsManager for the specified CmsServer. 


CmsServer 


getCmsServer (lava . lancr . Strincr id) 

Returns the cms server that has the specified ID. 


Connection 


getConnection (java. lang. String role) 
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get a Connection with role 


Connection 


getConnection ( java. lancr. Strincr role, 
java. lang. String itemtypeName) 

get a connection with role and typeName 


void 


releaseConnection (Connection conn) 


release the Connection to the Connection Pool. 



1.3.10.1 addCmsServer 

public void addCmsServer ( Cms Server cmsServer) 
Adds a cmsServer to the list of available servers. 
Parameters: 

cmsServer - the CmsServer to add to the list of available CmsServerS for this 
CmsManager 



1.3.10.2 getCmsServer 

public CmsServer getCmsServer (java . lang. String id) 
Returns the CmsServer that has the specified ID. 
Parameters: 

id - ths unique ID of the CmsServer 
Returns: 

the CmsServer that has the specified ID; null if it doesn't exist 



1.3.10.3 addRoutingProperty 

public void addRoutingProperty ( CmsServer cmsServer, 

java. lang. String propertyName, 
java. lang. St ring propertyValue) 

Adds a routing property to this CmsManager for the specified CmsServer. 

Parameters: 

cmsServer - the CmsServer concerned by this routing rule 
propertyName - the name of the property 
propertyValue - the value of the property 



1 .3.1 0.4 getConnection 

public Connection getConnection (java . lang. String role) 

throws CmsException 
get a Connection with role 
Parameters: 
role - the user role 
Returns: 
a Connection 
Throws: 

CmsException - in case of errors 



196 



1 .3.10.5 getConnection 

public Connection getConnection (java . lang. String role, 

java. lang. String itemtypeName) 
5 throws CmsException 

get a connection with role and typeName 
Parameters: 
role - the user role 

itemtypeName - the name of the item type 
10 Returns: 

s Connection 
Throws: 

CmsException - in case of errors 



15 1.3.10.6 releaseConnection 

public void releaseConnection ( Connection conn) 

throws CmsException 
release the Connection to the Connection Pool. 
Parameters: 
20 conn - the Connection to release 

Throws: 

CmsException - in case of errors 

25 The following example illustrates how the Item Factory, Item, ItemType objects interact 
together in the context of a web application. 

For example, a business process requires access to news articles published on a 
given date. The business process makes a content request for Items of ItemType 

30 "News" from the CMS. The business process is interested in the fields: "Author", "Data 
published", "Title", and "Body" in order to create a list of available news articles. The 
"getNews" business process resides as a Java class running as part of a Java based 
Web server. The application server (or web server) is first initialized and the CMS 
Manager object (com.conceptis.cms.util. DefaultCmsManagerlmpI) is instantiated. 

35 Each driver is assigned to the CMS Server object and is registered with the CMS 
Manager. For example, the business process "getNews" is invoked by the web server 
to retrieve a piece of content. The business process first makes a request to the CMS 
Manager object to get a connection to a CMS. Once the business process has a 
Connection object, the business process asks the Connection object for an 

40 ItemFactory object by invoking Connection.getltemFactory. The business process can 
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now instruct the ItemFactory to retrieve a piece of content, either by specifying the 
"Primary key" of the Item or other search criteria. The business process "getNews" 
creates an ItemSearchConstraints object and set the ItemType to "News" by invoking, 
constraints.add Item Type (Connection.getltemTypeFactoryQ. getltemType("News")) 
5 and the Date constraints to the desired dates. The method ltemFactory.search() is 
invoked by passing the search constraints object returning a List of Items that match 
the search. The business process "getNews" can now iterate through the returned list 
extracting the items Field data as desired, e.g. to retrieve a given items "Title" field, 
"getNews" would first get the Field object for the given ItemType using 
10 ltemType.getField(*Title"). Then, "getNews" could invoke Item.getFieldValue(Field) 
and be able to use the field data according to its field type (i.e. String, Date, integer, 
etc.) 

The web-server, where one or more business processes (BP's) or services reside, is 
15 responsible for instantiating the CMS Manager object, which will manage any 
connections that the BP may require with the external CMS. The web-server then, for 
each previously identified CMS, creates a CMS Server object that gets registered with 
the CMS Manager. The web-server must be aware, typically using a configuration file, 
of the actual implementation class names for each CMS Server 2. The CMS Server 2, 
20 on creation, loads the actual CMS Driver Interface 4 according to a parameter. The 
CMS Server 2 is then responsible for relaying connection requests between the 
implementation class and any BP. 

In other words the Connection object is the applications main entry point into the 
25 CMS. The Connection class implementation is responsible for implementing the 

methods that will provide access to the content Items themselves. The methods that 

the Connection implements include the following: 

getltem Factory 

getltemTypeFactory 
30 getlndexFactory 

getCmsUserFactory 
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The application gets the Connection object reference by calling 
DriverManager.getConnection method, which is able to locate the method 
implementation since the driver must have registered itself with the CMS Manager 
class as part of the driver's initialization. 

5 

The application is now able to access content Items by referencing the virtual or 
abstract instances of the Item class and its Fields. The application can query the Items 
to get information as to what fields the Item contains, e.g. using 
Item.getltemType.getFields. The application can access the Field contents by then 
10 iterating through the returned list of Fields using Item.getFieldValue(Field). 

The application can also interrogate the Item to determine whether the Item is 
associated with other Items, in the case where the Item might be an article with one or 
more associated images. The application queries the Item by invoking its 
15 getRelatedltems(RelationType) method. To get a list of the Items children the 
application invokes: Item.getRelatedltems(RelationType.CHILD). The application can 
further query the returned Items. 

Figure 8 shows a sample deployment model of the system of the present invention. 
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While a preferred embodiment of this invention have been illustrated in the 
accompanying drawings and described above, it will be evident to those skilled in the 
art that changes and modifications may be made therein without departing from the 
essence of this invention. 



